cal_

Calendars

Per-calendar configuration: select for sync, set writability.

Endpoints

GET /v1/connections/{id}/calendars List calendars on a connection

PATCH /v1/connections/{id}/calendars/{calId} Update sync settings idempotent

Object shape

A calendar is a single named container within a connection (e.g. "Primary", "Work travel"). Sync is configurable per calendar.

Field	Type	Description
id	string	Prefixed cal_.
object	string	Always calendar.
connection_id	string	Parent connection.
external_id	string	Provider's identifier for this calendar (primary on Google, a UUID on Microsoft).
name	string	Display name.
color_hex	string?	Provider-assigned display color.
writable	boolean	True if events can be written back to this calendar.
selected	boolean	True if this calendar's events flow into ChronaPilot.
is_default	boolean	Primary calendar for the connection.
timezone	string	IANA timezone identifier.

List calendars on a connection

HTTP
GET /v1/connections/{id}/calendars

Update a calendar's sync settings

HTTP
PATCH /v1/connections/{id}/calendars/{calId}

Body:

JSON
{ "selected": true, "writable": true }

Marking a calendar selected: false immediately stops ingesting its events. Existing events remain.

Reference implementation

ConnectedCalendar.cs — entity

{ "object": "list", "data": [ { "id": "cal_5g2h9j4k", "object": "calendar", "connection_id": "con_1abc2def3ghi", "external_id": "primary", "name": "Primary", "color_hex": "#5484ED", "writable": true, "selected": true, "is_default": true, "timezone": "America/Los_Angeles" } ], "has_more": false, "request_id": "req_1A2b3C4d5E6f" }