Skip to main content
POST
Approve or deny an access request

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.

requestId
string
required

Body

application/json
resolution
enum<string>
required
Available options:
approve,
deny

Response

Resolved request.

id
string
Example:

"areq_…"

agent_id
string
agent_name
string
role
enum<string>
Available options:
owner,
writer,
reader
message
string
status
enum<string>
Available options:
pending,
approved,
denied
created_at
string<date-time>