Availability

Three endpoints for finding available time slots.

Single-agent availability

Returns available slots across all of an agent’s calendars.

GET /v1/agents/:id/availability

Query parameters

Parameter	Type	Required	Default	Description
start	datetime	Yes	—	Start of time range (ISO 8601)
end	datetime	Yes	—	End of time range (must be after start)
slot_duration	string	No	30m	15m, 30m, 45m, 1h, or 2h
include_busy	boolean	No	false	Include busy slots in response

Example

curl "https://api.chronary.ai/v1/agents/agt_a1b2c3d4/availability?start=2026-04-07T09:00:00Z&end=2026-04-07T17:00:00Z&slot_duration=30m" \
  -H "Authorization: Bearer chr_sk_test_your_key_here"

Response 200 OK

{
  "slots": [
    { "start": "2026-04-07T09:00:00Z", "end": "2026-04-07T09:30:00Z" },
    { "start": "2026-04-07T09:30:00Z", "end": "2026-04-07T10:00:00Z" },
    { "start": "2026-04-07T15:00:00Z", "end": "2026-04-07T15:30:00Z" }
  ]
}

---

Single-calendar availability

Same parameters, scoped to one calendar.

GET /v1/calendars/:id/availability

Example

curl "https://api.chronary.ai/v1/calendars/cal_x1y2z3/availability?start=2026-04-07T09:00:00Z&end=2026-04-07T17:00:00Z" \
  -H "Authorization: Bearer chr_sk_test_your_key_here"

Errors

Status	Type	Cause
404	not_found	Calendar not found

---

Cross-agent availability

Find time slots where multiple agents are all free.

GET /v1/availability

Query parameters

Parameter	Type	Required	Default	Description
agents	string	Yes	—	Comma-separated agent IDs
start	datetime	Yes	—	Start of time range (ISO 8601)
end	datetime	Yes	—	End of time range
slot_duration	string	No	30m	15m, 30m, 45m, 1h, or 2h
calendars	string	No	—	Comma-separated calendar IDs to narrow scope
include_busy	boolean	No	false	Include busy slots

Example

curl "https://api.chronary.ai/v1/availability?agents=agt_a1b2c3d4,agt_e5f6g7h8&start=2026-04-07T09:00:00Z&end=2026-04-07T17:00:00Z&slot_duration=30m" \
  -H "Authorization: Bearer chr_sk_test_your_key_here"

Plan limits

Plan	Max agents per query	Max date range
Free	5 agents	30 days
Pro	20 agents	90 days
Scale	50 agents	365 days

Errors

Status	Type	Cause
400	bad_request	Too many agents for your plan
400	bad_request	Date range exceeds plan limit