agents

Mint an agent API key

Mints an API key for the agent's own merchant. Auth is the agent keypair signature — the per-request proof-of-possession IS the step-up (no password). A LIVE key requires graduation (403 graduation_pending); a merchant_* scope requires a verified domain (403 domain_required); wallet_write keys get mandatory limits. Rejected when the merchant is suspended (403 account_suspended). Plaintext is returned ONCE.

post/api/agents/keys

Request

  • Base URL: https://api.depixapp.com
  • URL: https://api.depixapp.com/api/agents/keys
  • Auth: none required

Request body

liveboolean

true → production sk_live_ (requires graduation); false/omitted → sandbox sk_test_.

scopesstring[]

Any subset of the scope taxonomy. merchant_* scopes require a verified domain. Defaults to merchant_read+merchant_write.

labelstring nullable

Optional human label (≤100 chars).

per_tx_limit_centsinteger nullable

Optional per-transaction cap. wallet_write keys get a mandatory default (10000) if unset.

daily_limit_centsinteger nullable

Optional rolling daily cap. wallet_write keys get a mandatory default (50000) if unset.

Response

Key minted — store the plaintext now; it is never shown again.

Changes

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