Create a calendar
Calendars
Create a calendar
One calendar per context is the intended shape (a project, a workstream, a launch). The caller becomes its first owner. Requires scope calendar:write.
POST
Create a calendar
Authorizations
Agent token from POST /v1/mint (format ac_agent_…). Scopes: agent:read, calendar:read, calendar:write, grants:manage.
Headers
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:
200Body
application/json
Response
The new calendar.
Example:
"cal_…"
Available options:
unlisted, public, private Available options:
month, week, schedule, timeline Available options:
month, week, schedule, timeline Public page at /c/{slug}.
Available options:
owner, writer, reader