On-Call API › Overrides
List overrides
GET/api/v1/schedules/{id}/overrides
Lists the schedule's overrides. A schedule that belongs to a team is visible only to callers in that team (and to administrators acting in person); others get 404, as if it did not exist.
Permission (API-key scope): oncall:schedule:read.
Authorization
bearerAuth(oncall:schedule:read)apiKeyHeader(oncall:schedule:read)
Parameters
Path parameters
idstring requiredThe schedule's id.
Responses
200
The overrides.
dataarray of ScheduleOverride requiredShow ScheduleOverride properties
idstringschedule_idstringuser_idstringWhom the override covers, when recorded.override_user_idstringWho is on call instead.start_timestring (date-time)end_timestring (date-time)reasonstringcreated_atstring (date-time)
successboolean required
401
No API key was sent, or it is unknown, revoked or expired (UNAUTHORIZED).
errorobject requiredcodestring requiredMachine-readable code. Branch on this.messagestring requiredHuman-readable explanation.
403
The key lacks the scope this endpoint needs (FORBIDDEN).
errorobject requiredcodestring requiredMachine-readable code. Branch on this.messagestring requiredHuman-readable explanation.
404
No schedule with this id in your organization (NOT_FOUND).
errorobject requiredcodestring requiredMachine-readable code. Branch on this.messagestring requiredHuman-readable explanation.
429
Too many requests (RATE_LIMITED). Wait Retry-After seconds.
Retry-AfterintegerSeconds to wait.
errorobject requiredcodestring requiredMachine-readable code. Branch on this.messagestring requiredHuman-readable explanation.
500
Something went wrong on EvoHub's side (INTERNAL_ERROR). Retry later.
errorobject requiredcodestring requiredMachine-readable code. Branch on this.messagestring requiredHuman-readable explanation.
Example request
curl -X GET 'https://evohub.io/api/v1/schedules/5b1c7d2e-8f3a-4b9c-a0d1-e2f3a4b5c6d7/overrides' \
-H 'Authorization: Bearer <TOKEN>'