> ## Documentation Index
> Fetch the complete documentation index at: https://docs.beachdepository.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cancel Transfer

> Cancel a pending transfer

Cancels a pending transfer batch. Only transfers that have not yet been approved can be cancelled. Pending transfers hold no inventory, so cancelling releases nothing — items remain in the vault.

**Permission:** `transfer_batches:update`

## Path parameters

<ParamField path="id" type="string" required>
  The transfer ID
</ParamField>

## Request body

<ParamField body="reason" type="string">
  Optional free-text reason for the cancellation.
</ParamField>

## Response

Returns the cancelled transfer.

```json theme={null}
{
  "data": {
    "id": "jx7transfer123",
    "fromFboAccountId": "m97fbo456",
    "toFboAccountId": "m97fbo789",
    "organizationId": "k57orgxyz",
    "status": "cancelled",
    "totalItems": 5,
    "approvedBySystem": false,
    "notes": "Quarterly rebalance",
    "createdAt": "2025-05-20T11:00:00Z"
  }
}
```