Skip to navigation
API ReferenceAgent Wallets

Create a wallet

View as Markdown
Create an Agent Wallet for a customer.

Authentication

x-api-keystring

Account API key used to authenticate server-side requests. Use the credentials issued for the same environment as the API base URL.

Path parameters

idstringRequired
Unique identifier of the resource.

Headers

Idempotency-KeystringOptional<=255 characters

Unique key used to safely retry the same state-changing request.

Request

This endpoint expects an object.
namestringRequired<=80 characters
What the customer calls this pot. The agent names it when paying, so it should read the way the customer would say it.
limitsobjectOptional

What an agent may spend from this wallet, in USD. Zero is an explicit “no limit”; an omitted field keeps whatever the wallet inherited.

Response

Wallet created successfully.
messagestring
dataobject

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error