Update calendar settings
Calendars
Update calendar settings
Partial update. JSON null clears nullable fields (purpose, default_view; views: null or [] means all lenses). Renaming the slug keeps every old slug 308-redirecting forever; a taken slug returns 409 slug_taken with error.details.available suggestions.
PATCH
Update calendar settings
Authorizations
Agent token from POST /v1/mint (format ac_agent_…). Scopes: agent:read, calendar:read, calendar:write, grants:manage.
Path Parameters
cal_… public id.
Body
application/json
Maximum string length:
200Available options:
unlisted, public, private Markdown; what this calendar is for. Shown at /c/{slug}/purpose.md.
Maximum string length:
8192Available options:
month, week, schedule, timeline, null Allowed lenses; null or [] = all.
Available options:
month, week, schedule, timeline Response
Updated 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