# Ask to Cancel a Desk Order

> Coming soon, upon request — this feature is turned on for your tenant by the Aurea team. [Contact us](https://www.aureahub.com/contact)

Ask the desk to cancel an order; the desk decides.

## Overview

- The request's `status`: `open`, `sent_to_provider`, then `cancelled` or `not_cancelled`; `withdrawn` when the request was dropped.
- One request at a time per order (`409` `BANK_RAMP_ORDER_CANCELLATION_OPEN`); an order that ended answers `409` `BANK_RAMP_ORDER_FINAL`.
- The order's `status` then moves with the desk's decision, and every change is sent as `ramp.desk_order.updated`.

Called with the user's access token, in one environment (`isTestnet`). See [Bank Ramp: Desk Orders](https://docs.aureahub.com/docs/guide-bank-desk.md).

## Endpoint

### `POST /v1/ramp/bank/customer/desk/orders/{id}/cancellation`

Authentication: bearer token required.

Asks the desk to cancel an order.

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string (uuid) | yes | The record's `id` |

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `isTestnet` | boolean | no | `true` for the sandbox; `false` or omitted for production |

**Request body**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `reason` | string | yes | Why, 3 to 500 characters |

**Responses**

`201` Requested

```json
{
  "id": "4c6e8a0b-2d4f-4b6d-8f0a-1c3e5a7c9e85",
  "orderId": "8f0a2c4e-6b8d-4f1a-a3c5-e7091b3d5f74",
  "status": "open",
  "reason": "The beneficiary changed bank",
  "createdAt": "2026-10-23T09:00:02.000Z"
}
```

---

Web version: https://docs.aureahub.com/#desk-cancellation