patch
https://connect.agendapro.com/v3/bookings/
This endpoint updates an existing booking. Only provided fields are updated (partial update).
Customer policy enforcement
Updates are validated against the merchant's customer policy before being applied. If the merchant has disabled edits, the booking is too close to its start time, or it has reached its maximum number of changes, the request is rejected with 422 restricted and the detail field identifies which rule tripped:
| Detail | Meaning |
|---|---|
can_edit | Merchant disabled edits via the customer flow. |
before_edit_booking | Booking is within the merchant's pre-start lock window (no edits allowed this close to start_time). |
max_changes | Booking has reached the merchant's maximum number of changes. |
These values are configured by the merchant in Configuraciones > Sitio web > Edición y cancelación de reservas en línea.
Clients integrating against this API should surface these conditions to their end users as "the merchant does not allow this change" rather than retrying the request.
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 bookings:write scope. |
| 404 | not_found | booking | Booking not found. |
| 422 | restricted | can_edit | Merchant has disabled edits via the customer flow. |
| 422 | restricted | before_edit_booking | Booking is within the merchant's pre-start lock window. |
| 422 | restricted | max_changes | Booking has reached the merchant's maximum number of changes. |
| 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…