---
title: "Withdraw a pending request"
method: POST
path: "/approvals/{approval_id}/cancel"
tags: ["approval"]
---

# Withdraw a pending request

`POST /approvals/{approval_id}/cancel`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/approvals/{approval_id}/cancel`
- Auth: HTTP bearer

## Path parameters

- `approval_id` string, required

## Request body

- object
  - `reason` string

## Response `200`

The result.

- object
  - `id` string, required
  - `status` 'pending' | 'approved' | 'rejected' | 'expired' | 'cancelled' | 'executed' | 'partially_executed' | 'failed', required
  - `summary` string, required
  - `payload_hash` string, required
  - `approval_url` string, required
  - `requester` object, required
    - `type` 'agent_connection' | 'api_key', required
    - `id` string, required
  - `on_behalf_of` string, required
  - `expires_at` string, date-time, required
  - `decided_by` string, nullable, required
  - `decided_at` string, date-time, nullable, required
  - `rejection_reason` string, nullable, required
  - `items` object[], required
    - `id` string, required
    - `position` integer, required
    - `action` string, required
    - `risk` 'outward' | 'legal' | 'admin', required
    - `summary` string, required
    - `status` 'pending' | 'approved' | 'rejected' | 'executed' | 'failed' | 'cancelled', required
    - `input` union, required
      - string
      - number
      - boolean
      - EnvelopeEventsOutSchema0[]
        - union
          - string
          - number
          - boolean
          - EnvelopeEventsOutSchema0[]
          - object
      - object
    - `result` union, required
      - string
      - number
      - boolean
      - EnvelopeEventsOutSchema0[]
        - union
          - string
          - number
          - boolean
          - EnvelopeEventsOutSchema0[]
          - object
      - object
    - `error` object, nullable, required
      - `code` string, required
      - `message` string, required
      - `hint` string
    - `executed_at` string, date-time, nullable, required

## Other responses

- `default`: An RFC 9457 problem.

---

[API](https://skmtc.dev/binderwork/apis/binderwork-api.md) · [All operations](https://skmtc.dev/binderwork/apis/binderwork-api/llms.txt) · [OpenAPI document](https://skmtc.dev/binderwork/apis/binderwork-api/revisions/f8fab0ebee53?raw)