Wallets

Grant agent access to wallet

Grant an owned or customer-connected agent access to a standard wallet. Customer connections also require delegations.update. The first wallet becomes the default; adding another preserves the existing default. Agent credentials and delegated callers cannot manage wallet access.

post/wallets/{walletId}/agents

Path parameters

walletIdstring required

Wallet ID (wal_*).

Headers

Idempotency-Keystring required

Unique key for safely retrying a request without creating duplicates.

X-Instance-IDstring nullable

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

Request body

Response

Successful Response

Changes