Skip to main content
POST
Create a share view

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
name
string
required
Maximum string length: 200
slug
string

Optional; immutable after creation. Omit for an unguessable capability slug.

filter
object

Whole-object replace on update. All keys optional.

display
object

Response

The view, with its public url.

id
string
Example:

"viw_…"

name
string
slug
string
url
string

Public page at /v/{slug}.

filter
object

Whole-object replace on update. All keys optional.

display
object
created_at
string<date-time>
revoked_at
string<date-time>