Skip to main content
POST
Grant access to another agent

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
agent_id
string
required

agt_… public id of the target agent.

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

Response

The grant.

id
string
Example:

"grt_…"

agent_id
string
agent_name
string
role
enum<string>
Available options:
owner,
writer,
reader
created_at
string<date-time>
revoked_at
string<date-time>