Transfers

Initiate withdrawal

Move funds from a wallet to a linked bank account

post/transfers/withdraw

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

Changed in 9 of the 50 revisions of this API.2924

Sep 23, 2026bcf3b028c3e512See the full diff
- ●
  removed the request property //
  request-property-removed
- ○
  added the new optional request property //
  new-optional-request-property
- ○
  added the required property // to the response with the status
  response-required-property-added
Sep 22, 20264a05af81217f7See the full diff
- ●
  added the new ach enum value to the /// response property for the response status
  response-property-enum-value-added
- ●
  added the new instant enum value to the /// response property for the response status
  response-property-enum-value-added
- ●
  added the new internal enum value to the /// response property for the response status
  response-property-enum-value-added
- ●
  added the new realtime enum value to the /// response property for the response status
  response-property-enum-value-added
- ●
  added the new standard enum value to the /// response property for the response status
  response-property-enum-value-added
- ●
  added the new wire enum value to the /// response property for the response status
  response-property-enum-value-added
- ●
  added the new wire enum value to the /// response property for the response status
  response-property-enum-value-added
Sep 2, 2026c7c12da5915f12See the full diff
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
Aug 27, 2026359d267dca881See the full diff
- ○
  deleted the header request parameter X-Agent-ID with deprecation
  request-parameter-removed-with-deprecation
Aug 23, 2026b1ad79e918ac1See the full diff
- ○
  header request parameter X-Agent-ID was deprecated
  request-parameter-deprecated
Aug 15, 202609487fd56e291See the full diff
- ○
  added the new optional request property //
  new-optional-request-property
Aug 13, 2026ba1fb54c59393See the full diff
- ○
  added the new optional request property //
  new-optional-request-property
- ○
  added the new wire enum value to the request property //
  request-property-enum-value-added
- ○
  added the required property // to the response with the status
  response-required-property-added
Aug 6, 20265b54392d36993See the full diff
- ○
  added the new optional request property //
  new-optional-request-property
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
Jul 26, 2026270e233e401c211See the full diff
- ▲
  request property // was restricted to a list of enum values
  request-property-became-enum
- ▲
  the // request property's maxLength was decreased to 80
  request-property-max-length-decreased
- ●
  for the header request parameter Idempotency-Key, the maxLength was set to 255
  request-parameter-max-length-set
- ○
  added the new USD enum value to the request property //
  request-property-enum-value-added

Full history