Transfers

Initiate internal transfer

Move funds between two wallets

post/transfers/internal

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 10 of the 50 revisions of this API.1922

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, 2026ba1fb54c59392See 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
Aug 6, 20265b54392d36992See the full diff
- ○
  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, 2026270e233e401c11See the full diff
- ▲
  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
Jul 14, 20268cc2aed458471See the full diff
- ○
  endpoint added
  endpoint-added

Full history