Approvals

Deny payment or transfer

Deny the payment or transfer under review

post/approvals/{approvalId}/deny

Path parameters

approvalIdstring required

Approval ID (apr_*).

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 8 of the 31 revisions of this API.2222

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 28, 202625b811746e7a2See the full diff
- ○
  request body became optional
  request-body-became-optional
- ○
  the request property became optional
  request-property-became-optional
Aug 27, 2026359d267dca881See the full diff
- ○
  deleted the header request parameter X-Agent-ID with deprecation
  request-parameter-removed-with-deprecation
Aug 27, 2026feb2ede0653913See the full diff
- ▲
  added required request body
  request-body-added-required
- ○
  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
- ○
  added the required property // to the response with the status
  response-required-property-added
Aug 23, 2026b1ad79e918ac1See the full diff
- ○
  header request parameter X-Agent-ID was deprecated
  request-parameter-deprecated
Aug 11, 2026089aed4017a811See the full diff
- ●
  added the new ach enum value to the /// response property for the response status
  response-property-enum-value-added
- ○
  removed the direct_payment enum value from the /// response property for the response status
  response-property-enum-value-removed
Aug 9, 20260123533d83611See the full diff
- ●
  added the new direct_payment enum value to the /// response property for the response status
  response-property-enum-value-added
Jul 26, 2026270e233e401c12See the full diff
- ▲
  added the new required header request parameter Idempotency-Key
  new-required-request-parameter
- ○
  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

Full history