List an assistant's calendars

GET/assistants/{id}/calendars

The calendars the assistant books meetings on during a call, in the order they were added. Each has a handle the prompt mentions, a status, and the account it is connected to.

Request

curl -X GET "https://www.getrevox.com/api/assistants/3f6c2a1e-8b4d-4c7a-9e2f-5d1b7a9c0e34/calendars" \
  -H "Authorization: Bearer $REVOX_API_KEY"

const res = await fetch("https://www.getrevox.com/api/assistants/3f6c2a1e-8b4d-4c7a-9e2f-5d1b7a9c0e34/calendars", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.REVOX_API_KEY}`,
  },
});
const data = await res.json();
console.log(data);

import os

import requests

response = requests.get(
    "https://www.getrevox.com/api/assistants/3f6c2a1e-8b4d-4c7a-9e2f-5d1b7a9c0e34/calendars",
    headers={"Authorization": f"Bearer {os.environ['REVOX_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
print(response.json())

Try itSend this request live

Response

Success

{
  "calendars": [
    {
      "id": "b2d4f6a8-1c3e-4a5b-8d7f-9e0a1b2c3d4e",
      "assistant_id": "3f6c2a1e-8b4d-4c7a-9e2f-5d1b7a9c0e34",
      "handle": "google_calendar_jane_at_example.com",
      "provider": "google-calendar",
      "status": "ready",
      "connection": {
        "provider": "google-calendar",
        "connection_id": "9b8a7c6d-5e4f-4a3b-9c2d-1e0f9a8b7c6d",
        "settings": {
          "calendar_id": "primary",
          "time_zone": "Europe/Paris",
          "duration_minutes": 30,
          "days": [1, 2, 3, 4, 5],
          "start_time": "09:00",
          "end_time": "18:00",
          "google_meet": false,
          "location": "{{site_address}}"
        }
      },
      "account_label": "Main line",
      "connected_via_invite": false,
      "invite": {
        "url": "https://example.com",
        "status": "completed",
        "created_at": "2026-11-05T09:00:00Z",
        "expires_at": "2026-11-05T09:00:00Z"
      },
      "created_at": "2026-11-05T09:00:00Z"
    }
  ]
}

{ "error": "Not found" }

Path parameters

idstringrequired
ID of the assistant, as returned by GET /assistants.

Request body

No body: send the request without one.

Response

200

calendarsarray of AssistantCalendar
The assistant's calendars, oldest first.

Errors

404Not found in your organization{ "message"?: string, "error"?: string, "bodyErrors"?: {…} }

Error bodies carry an error (or message) string; a 400 adds bodyErrors.issues. See Errors.