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

# Delete Transfer: Permanently Remove a Transfer

> Permanently delete an AgentDrop transfer and remove all encrypted file blobs from R2 storage. Recipient sees 410 Gone for any subsequent download attempt.

Mark a transfer as deleted. Files are cleaned up by a background worker.

<Note>
  Deletion is soft, the transfer record remains for audit purposes but files are removed from storage and the transfer can no longer be downloaded.
</Note>

## Request

### Headers

<ParamField header="Authorization" type="string" required>
  Bearer token. Example: `Bearer agd_live_xxxxxxxxxxxxxxxxxxxx`
</ParamField>

### Path Parameters

<ParamField path="id" type="string" required>
  The transfer ID. Example: `txfr_abc123`
</ParamField>

## Response

```json theme={null}
{
  "id": "txfr_abc123",
  "status": "deleted",
  "deleted_at": "2026-03-22T14:30:00Z"
}
```

## Examples

<CodeGroup>
  ```bash curl theme={null}
  curl -X DELETE https://api.agent-drop.com/v1/transfers/txfr_abc123 \
    -H "Authorization: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx"
  ```

  ```python Python theme={null}
  response = requests.delete(
      "https://api.agent-drop.com/v1/transfers/txfr_abc123",
      headers={"Authorization": "Bearer agd_live_xxxxxxxxxxxxxxxxxxxx"},
  )

  print(response.json()["status"])  # "deleted"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.agent-drop.com/v1/transfers/txfr_abc123",
    {
      method: "DELETE",
      headers: { Authorization: "Bearer agd_live_xxxxxxxxxxxxxxxxxxxx" },
    }
  );

  const result = await response.json();
  console.log(result.status); // "deleted"
  ```
</CodeGroup>

## Errors

| Status | Code           | Description                                |
| ------ | -------------- | ------------------------------------------ |
| `401`  | `UNAUTHORIZED` | Invalid or missing API key                 |
| `404`  | `NOT_FOUND`    | Transfer does not exist or already deleted |