latestOpenAPI 3.1.12026-08-239938.6 MB

b1ad79e918ac

Wallets

Set default wallet

Set the party's default wallet, where payments addressed to their email, phone number, or handle land

post/wallets/{walletId}/default

Path parameters

walletIdstring required

Wallet ID (wal_*).

Headers

Idempotency-Keystring required

Unique key for safely retrying a request without creating duplicates.

X-Agent-IDstring nullable

Deprecated: agent identity comes from the credential. Sending this header with a party API key or user credential returns 403 agent_credential_required.

X-Instance-IDstring nullable

Caller-chosen identifier for the agent run, session, or conversation, required when an agent moves money.

Response

Successful Response