Availability
A host's availability is a set of weekly rules plus date overrides, all in the host's timezone. Minutes are counted from midnight (540 is 09:00), and weekday is 0 for Sunday through 6 for Saturday. A rule must end after it starts and rules on the same weekday cannot overlap (overlapping_rules).
An override replaces the rules for one date. Give it a start and end minute to open different hours, or set both to null to block the whole day. All endpoints need an API key.
GET /availability
Weekly rules and date overrides. Auth: API key.
Response 200
Body
| Field | Type | Required | Default / limits |
|---|---|---|---|
timezone | string | yes | - |
rules | object[] | yes | - |
rules[].weekday | integer | yes | 0–6 |
rules[].startMinute | integer | yes | 0–1440 |
rules[].endMinute | integer | yes | 0–1440 |
overrides | object[] | yes | - |
overrides[].date | string (date) | yes | - |
overrides[].startMinute | integer | null | yes | - |
overrides[].endMinute | integer | null | yes | - |
overrides[].id | string (uuid) | yes | - |
Errors: unauthorized
curl -X GET "https://devalender.com/api/availability" \
-H "Authorization: Bearer dvl_..."PUT /availability/rules
Replace the weekly rules. Auth: API key.
Request body
| Field | Type | Required | Default / limits |
|---|---|---|---|
rules | object[] | yes | max 100 items |
rules[].weekday | integer | yes | 0–6 |
rules[].startMinute | integer | yes | 0–1440 |
rules[].endMinute | integer | yes | 0–1440 |
Response 200
Body
| Field | Type | Required | Default / limits |
|---|---|---|---|
rules | object[] | yes | - |
rules[].weekday | integer | yes | 0–6 |
rules[].startMinute | integer | yes | 0–1440 |
rules[].endMinute | integer | yes | 0–1440 |
Errors: invalid_request, overlapping_rules, unauthorized
curl -X PUT "https://devalender.com/api/availability/rules" \
-H "Authorization: Bearer dvl_..." \
-H "Content-Type: application/json" \
-d '{"rules":[{"weekday":1,"startMinute":540,"endMinute":1020}]}'POST /availability/overrides
Add a date override. Auth: API key.
Request body
| Field | Type | Required | Default / limits |
|---|---|---|---|
date | string (date) | yes | - |
startMinute | integer | null | yes | - |
endMinute | integer | null | yes | - |
Response 201
Body
| Field | Type | Required | Default / limits |
|---|---|---|---|
date | string (date) | yes | - |
startMinute | integer | null | yes | - |
endMinute | integer | null | yes | - |
id | string (uuid) | yes | - |
Errors: invalid_request, unauthorized
curl -X POST "https://devalender.com/api/availability/overrides" \
-H "Authorization: Bearer dvl_..." \
-H "Content-Type: application/json" \
-d '{"date":"2030-01-07","startMinute":null,"endMinute":null}'DELETE /availability/overrides/:id
Remove a date override. Auth: API key.
Path parameters
| Field | Type | Required | Default / limits |
|---|---|---|---|
id | string | yes | - |
Response 204
No body.
Errors: unauthorized, not_found
curl -X DELETE "https://devalender.com/api/availability/overrides/<id>" \
-H "Authorization: Bearer dvl_..."