agents

Agent self-onboarding (atomic)

Creates an agent account + merchant + sandbox key + starter live key in one atomic transaction. Authentication is the agent keypair scheme via signed headers (X-Agent-Public-Key / X-Agent-Timestamp / X-Agent-Nonce / X-Agent-Signature — Ed25519 over the canonical string depix-agent-auth:v1\napi.depixapp.com\n{METHOD}\n{PATH}\n{timestamp}\n{nonce}\n{sha256hex(canonical-json-body)} — the body hash is over the compact JSON serialization), NOT a Bearer key — plus the REQUIRED operator_token anti-farm anchor. Key plaintexts and the webhook secret are returned ONLY here.

post/api/agents/register

Request

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

Request body

namestring required

Display/business name (2–100 chars). Becomes the merchant business_name.

usernamestring

Optional handle (3–30 chars, [a-zA-Z0-9_]). Defaults to agent_<first 10 hex of the public key>. Taken → 409 username_taken.

operator_tokenstring required

REQUIRED anti-farm anchor: the op_… token minted when the human operator connected via OAuth or the GitHub PAT fast-path. One operator token clusters N agents.

operator_emailstring required

Operator notification email (format-validated only; never becomes the account login email).

liquid_addressstring required

Static Liquid address for merchant receipts — produced by the agent's own wallet (the SDK derives it; not user-chosen). Immutable after registration.

default_callback_urlstring

Optional HTTPS webhook endpoint for deposit./withdraw./checkout.* events.

refstring

Optional referrer username for affiliate attribution.

Response

Agent created — store the key plaintexts and webhook secret now; they are never shown again.

Changes

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