ACH4

Agent Keys4

Agent Tokens7

Agents5

API Keys4

Approvals4

Card Payments2

Card Sessions4

Chargebacks8

Check4

Customers7

Events3

External Accounts5

External Parties4

External Party Accounts3

Invitation Links4

Invitations3

Merchant Reports1

Parties12

Payment Intents5

PaymentRequests7

Payments4

Realtime4

Refunds3

Simulations22

Transactions2

Transfers5

Voice4

Wallets11

Webhooks6

Wire4

Wallets

Set agent default wallet

Changed on Sep 26, 2026

Make this wallet the default for the attached agent. For a connected agent, the default applies only to this customer connection and also requires delegations.update. Omitted walletId calls use this default. Agent credentials and delegated callers cannot change it.

post/wallets/{walletId}/agents/{agentId}/default

Request

Base URL
https://api.natural.com
URL
https://api.natural.com/wallets/{walletId}/agents/{agentId}/default
Auth
HTTP bearer

Path parameters

walletIdstring required

Wallet ID (wal_*).

agentIdstring required

Agent ID (agt_*).

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.

Response

Successful Response

Changes

Sep 26, 2026ca3882d75a00 Revision changes
- info
  added the optional property /// to the response with the status
Sep 2, 2026c7c12da5915f Revision changes
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status

Operation history (6 revisions)