patch
https://connect.agendapro.com/v3/carts/
Updates a cart's items or client. Only carts belonging to the
authenticated company can be updated; other carts return 404.
Important Notes
- Requires
carts:writescope. - Sending
itemsreplaces the full items array. - Any payment request in
pendingstatus on the cart is cancelled automatically before applying the update, and on-demand bookings reserved by it are released. - The cart must not be expired and must not have paid or partially paid sales.
- Item validation errors (400/422) from platform-sales are passed through unchanged.
Errors Dictionary
| Status | Error | Detail | Description |
|---|---|---|---|
| 401 | unauthorized | invalid_api_key | Missing or invalid Bearer token. |
| 401 | unauthorized | api_config_inactive | API access is inactive for this company. |
| 403 | forbidden | scope_denied | API key lacks carts:write scope. |
| 404 | cart_not_found | Cart not found for this company. | |
| 422 | cart_expired | The cart has expired (older than 24 hours). | |
| 422 | cart_paid | The cart already has a paid sale. | |
| 400, 422 | (upstream) | Item validation errors from platform-sales are passed through with legacy single-key codes (e.g. item_invalid_type, invalid_start_time, creative_source_not_public); see the platform-sales carts documentation for the full list. | |
| 429 | rate_limited | burst_limit_exceeded | Per-minute request limit exceeded. |
| 429 | rate_limited | daily_quota_exceeded | Daily request quota exceeded. |
| 502 | upstream_unavailable | The upstream service is unavailable. |
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…