> The full uetr.ai documentation index is at https://uetr.ai/llms.txt, and every page under https://uetr.ai/docs/api is also Markdown at its address plus `.md`.

# Delete a transfer

Permanently delete a transfer from the account, archived or not, with its timeline. It cannot be undone; archiving keeps the transfer instead. Adding the UETR again later starts a new transfer.

`DELETE https://uetr.ai/api/v1/transfers/{uetr}`

- MCP tool: `delete_transfer`
- Access: a key or connection with read and write access

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `uetr` | path | string (matching `^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$`) | Yes | The transfer's UETR. |

## Response

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `deleted` | boolean | Yes |  |
| `uetr` | string | Yes | The UETR of the deleted transfer. |

## Example

```sh
curl -X DELETE "https://uetr.ai/api/v1/transfers/eb6305c9-1f7f-49de-aed0-16487c27b42d" \
  -H "Authorization: Bearer $UETR_API_KEY"
```

The answer:

```json
{
  "deleted": true,
  "uetr": "eb6305c9-1f7f-49de-aed0-16487c27b42d"
}
```

## Refusals

Besides the [access refusals](/docs/api/errors#access-refusals) every call can meet, this call can answer:

- [`read_only_credential`](/docs/api/errors#read_only_credential) (403): Read-only key or connection.
- [`machine_writes_disabled`](/docs/api/errors#machine_writes_disabled) (503): Changes are switched off.
- [`not_found`](/docs/api/errors#not_found) (404): Not found.
- [`not_permitted`](/docs/api/errors#not_permitted) (403): Not permitted.
- [`plan_unverified`](/docs/api/errors#plan_unverified) (503): Plan could not be verified.
- [`demo_transfer`](/docs/api/errors#demo_transfer) (409): The demo transfer cannot be changed.