Skip to main content
POST
Top up Agent Wallet

Authorizations

Authorization
string
header
required

User keys begin with darwin_. Application service-account keys begin with darwin_sa_ and are restricted to linked agents.

Headers

Idempotency-Key
string
required

A caller-generated key, unique to this operation and payload.

Required string length: 1 - 200

Path Parameters

agentId
string
required

Body

application/json
amountMinor
integer
required

Wallet amount to credit, in USD cents. The returned card charge includes processing costs.

Required range: 100 <= x <= 1000000

Response

Client details for confirming the wallet top-up.

clientSecret
string | null
required
publishableKey
string
required
amountMinor
integer
required
Required range: x >= 100
walletCreditAmountMinor
integer
required
Required range: x >= 100
processingFeeMinor
integer
required
Required range: x >= 0
chargeAmountMinor
integer
required
Required range: x >= 100
currency
enum<string>
required
Available options:
usd