Delete Transfer: Permanently Remove a Transfer

Delete Transfer

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

DELETE

transfers

{id}

Delete Transfer

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

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

Authorization

string

required

Bearer token. Example: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx

string

required

The transfer ID. Example: txfr_abc123

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

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

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