Skip to main content
DELETE
/
v1
/
transfers
/
{id}
Delete Transfer
curl --request DELETE \
  --url https://agentdrop-production.up.railway.app/v1/transfers/{id} \
  --header 'Authorization: <authorization>'

Delete Transfer

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://agentdrop-production.up.railway.app/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