Skip to main content
DELETE
/
v1
/
transfers
/
{id}
Delete Transfer
curl --request DELETE \
  --url https://api.agent-drop.com/v1/transfers/{id} \
  --header 'Authorization: <authorization>'

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.

Mark a transfer as deleted. Files are cleaned up by a background worker.
Deletion is soft, the transfer record remains for audit purposes but files are removed from storage and the transfer can no longer be downloaded.

​
Request

​
Headers

​
Authorization
string
required
Bearer token. Example: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx

​
Path Parameters

​
id
string
required
The transfer ID. Example: txfr_abc123

​
Response

{
  "id": "txfr_abc123",
  "status": "deleted",
  "deleted_at": "2026-03-22T14:30:00Z"
}

​
Examples

curl -X DELETE https://api.agent-drop.com/v1/transfers/txfr_abc123 \
  -H "Authorization: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx"

​
Errors

StatusCodeDescription
401UNAUTHORIZEDInvalid or missing API key
404NOT_FOUNDTransfer does not exist or already deleted