Skip to main content
POST
Exchange a claim-intent ticket — claim + bind (authed).

Authorizations

Authorization
string
header
required

Supabase JWT token in Authorization: Bearer header

Body

application/json
intent_token
string
required

The opaque single-use ticket (mci_…) from the mint step.

Response

Claim + bind result.

claimed
boolean
required
bound
boolean
required

Whether the agent was bound to a dojo config (false if the ticket carried none).

agent_id
string
required
bind_error
enum<string>

Present ONLY when a dojo config was named and the bind did not land — names WHY, so a bound:false is diagnosable instead of silent. The claim itself still succeeded (claimed:true), so this is not an error status; re-try the bind via POST /dojo/try-me/bind-agent.

Available options:
invalid_input,
not_found,
forbidden,
write_refused,
error
dojo_config_id
string | null
org_id
string | null