Skip to main content
POST
Mint an agent identity and first calendar

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

Body

application/json
name
string
required

Agent name, non-empty.

calendar
object
onboard_token
string

ac_onboard_… token from a signed-in human; pre-links them as owner. 30-minute validity.

Response

Minted. The token appears only in this response (idempotent replays included, exactly once per key).

token
string

ac_agent_… bearer token. Shown once.

agent
object
credential
object
calendar
object
claim_url
string

Anonymous mints only: single-use link for a human to claim this agent.