Skip to main content
POST
Attach a calendar as a layer

Authorizations

Authorization
string
header
required

Agent token from POST /v1/mint (format ac_agent_…). Scopes: agent:read, calendar:read, calendar:write, grants:manage.

Headers

Idempotency-Key
string
required

Any unique string you generate (e.g. a UUID). Required on every mutating POST. Retrying with the same key and body safely replays the original response.

Maximum string length: 200

Path Parameters

calendarId
string
required

cal_… public id.

Body

application/json
calendar_id
string
required

cal_… id of the calendar to attach.

key
string
required

Stable handle for filters, e.g. "marketing". "main" is reserved for the calendar's own events.

Pattern: ^[a-z0-9](?:[a-z0-9-]{0,38}[a-z0-9])?$

Response

The layer link.

id
string
Example:

"lyr_…"

key
string
calendar_id
string
calendar_name
string
calendar_slug
string
created_at
string<date-time>