Get agent availability

Returns free/busy slots for all calendars owned by the agent.

get/v1/agents/{id}/availability

Request

Base URL: https://api.chronary.ai
URL: https://api.chronary.ai/v1/agents/{id}/availability
Auth: HTTP bearer

Path parameters

idstring required

Agent ID

Example:agt_01H9X4M2P5R8T6V0

Query parameters

startstring date-time required

endstring date-time required

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

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

include_busy'true' | 'false'

allow_stale'true' | 'false'

Response

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.