Skip to main content
PATCH
Update calendar settings

Authorizations

Authorization
string
header
required

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

Path Parameters

calendarId
string
required

cal_… public id.

Body

application/json
name
string
Maximum string length: 200
timezone
string
visibility
enum<string>
Available options:
unlisted,
public,
private
slug
string
purpose
string | null

Markdown; what this calendar is for. Shown at /c/{slug}/purpose.md.

Maximum string length: 8192
default_view
enum<string> | null
Available options:
month,
week,
schedule,
timeline,
null
views
enum<string>[] | null

Allowed lenses; null or [] = all.

Available options:
month,
week,
schedule,
timeline

Response

Updated calendar.

id
string
Example:

"cal_…"

name
string
slug
string
timezone
string
visibility
enum<string>
Available options:
unlisted,
public,
private
purpose
string
default_view
enum<string>
Available options:
month,
week,
schedule,
timeline
views
enum<string>[]
Available options:
month,
week,
schedule,
timeline
url
string

Public page at /c/{slug}.

role
enum<string>
Available options:
owner,
writer,
reader