Get cross-agent availability

Returns intersected free/busy slots across multiple agents. Pass a comma-separated list of agent IDs in the agents query parameter. Optionally filter to specific calendar IDs with calendars. Requires Pro plan.

get/v1/availability

Request

Base URL: https://api.chronary.ai
URL: https://api.chronary.ai/v1/availability
Auth: HTTP bearer

Query parameters

agentsstring required

startstring date-time required

endstring date-time required

duration'15m' | '30m' | '45m' | '1h' | '2h'

slot_duration'15m' | '30m' | '45m' | '1h' | '2h'

calendarsstring

include_busy'true' | 'false'

allow_stale'true' | 'false'

Response

Intersected availability slots

agentsstring[] required

per_agent_busyobject

Busy blocks keyed by agent id. Present only when include_busy=true.

availability_state'complete' | 'stale' | 'partial' | 'unavailable' required

Whether all required Chronary and authorized human-calendar data was current for this result.

Example response

{
  "agents": [
    "agt_01H9X4M2P5R8T6V0"
  ],
  "slots": [
    {
      "start": "2025-01-20T09:00:00.000Z",
      "end": "2025-01-20T09:30:00.000Z"
    }
  ],
  "per_agent_busy": {
    "agt_01H9X4M2P5R8T6V0": [
      {
        "start": "2025-01-20T09:00:00.000Z",
        "end": "2025-01-20T09:30:00.000Z",
        "calendar_id": "cal_01H9X4M2P5R8T6V0"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.