# The AssistantCalendar object

## Fields

- `id` (string, required)
- `assistant_id` (string, required)
- `handle` (string, required, nullable): How the prompt names this calendar, as @handle: the provider, then the connected account (e.g. google_calendar_aric_at_getrevox.com). Null until an account is connected, unique within the assistant, kept when it is disconnected. Constraints: max length 255.
- `provider` (enum (string), required): One of: `google-calendar`, `calendly`, `cal-com-oauth`.
- `status` (enum (string), required): One of: `not_connected`, `needs_setup`, `ready`.
- `connection` (one of, required, nullable): The connected account, on the calendar's provider. Null until one is connected.
  - One of, **provider: "google-calendar"** (object)
    - `provider` (string (constant), required)
    - `connection_id` (string, required)
    - `settings` (object, required, nullable)
      - `calendar_id` (string, required): The Google calendar to book on. (eg: primary)
      - `time_zone` (string, required): The timezone of the opening hours. (eg: Europe/Paris)
      - `duration_minutes` (integer, required): Constraints: min 5, max 480. Default: `30`.
      - `days` (array of integer, required): The open days, 0 is Sunday. Default: `[1,2,3,4,5]`.
      - `start_time` (string, required): Constraints: pattern ^\d{2}:\d{2}$. Default: `"09:00"`.
      - `end_time` (string, required): Constraints: pattern ^\d{2}:\d{2}$. Default: `"18:00"`.
      - `google_meet` (boolean, required): Adds a Google Meet link to the meeting. Default: `true`.
  - One of, **provider: "calendly"** (object)
    - `provider` (string (constant), required)
    - `connection_id` (string, required)
    - `settings` (object, required, nullable)
      - `event_type_id` (string, required): The Calendly event type to schedule. (eg: https://api.calendly.com/event_types/b2330295-2a91-4a1d-bb73-99e7707663d5) Constraints: min length 1.
  - One of, **provider: "cal-com-oauth"** (object)
    - `provider` (string (constant), required)
    - `connection_id` (string, required)
    - `settings` (object, required, nullable)
      - `event_type_id` (string, required): The Cal.com event type to schedule. (eg: 7081322) Constraints: min length 1.
- `account_label` (string, required, nullable): The connected account, usually its email. Null when not connected, or when the provider did not say.
- `connected_via_invite` (boolean, required): True when the account was connected by a colleague from the invite link.
- `invite` (object, required, nullable)
  - `url` (string, required, nullable): Page where a colleague without a Revox account connects their own calendar to this one. Anyone holding the link can, until it expires. Only given by the calendar endpoints, null on a calendar listed in an assistant.
  - `status` (enum (string), required): One of: `pending`, `completed`, `expired`.
  - `created_at` (any, required)
  - `expires_at` (any, required)
- `created_at` (any, required)