Register (provision) a new agent

Create an agent under a wallet and receive its API key once. Accepts seat fields: holder (who holds it) and expires_at (contractor auto-shutoff — the key fails closed past that instant). Management-plane (x-mgmt-key).

post/agents

Request

  • Base URL: https://getsanction.com/api/v1
  • URL: https://getsanction.com/api/v1/agents
  • Auth: API key in header x-mgmt-key

Request body

wallet_idstring required
namestring required

Agent name. Carry your tenant id here (e.g. tenant_<id>) to map one agent per tenant.

Response

Agent created; api_key shown once

idstring
namestring
api_keystring

The agent key (pxy_...). Store it now — shown once.

api_key_prefixstring
wallet_idstring
created_atstring date-time
warningstring

Changes

No recorded changes to this operation across all 1 revision of this API.