post
https://connect.agendapro.com/v3/provider_breaks
This endpoint blocks time in a provider's schedule.
Important Notes
- Breaks do not check for overlaps with existing bookings.
- Recurring breaks are created with
POST /v3/provider_break_repeats. - Dates follow the local-time convention described in Dates and times.
- Errors from platform-services use legacy single-key codes (e.g.
provider_not_found,google_event_break), withoutdetail; errors from Connect itself (auth, scope, rate limit) keep{error, detail}.
Errors Dictionary
| Status | Error | Detail | Description |
|---|---|---|---|
| 400 | missing_start_date | start_date is missing. | |
| 400 | missing_end_date | end_date is missing. | |
| 400 | invalid_start_date | start_date is not a valid date-time. | |
| 400 | invalid_end_date | end_date is not a valid date-time. | |
| 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 provider_breaks:write scope. |
| 404 | provider_not_found | The provider does not exist or belongs to another company. | |
| 422 | invalid_end_date | end_date is not at least one minute after start_date. | |
| 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…