Skip to main content
POST
/
v1
/
transfers
/
{id}
/
confirm
Confirm Transfer
curl --request POST \
  --url https://api.agent-drop.com/v1/transfers/{id}/confirm \
  --header 'Authorization: <authorization>'
{
  "id": "<string>",
  "status": "<string>"
}
After uploading all files to the presigned URLs returned by presigned-upload, call this endpoint to activate the transfer. The transfer moves from pending to active status and becomes available for the recipient to download.

​
Request

​
Headers

​
Authorization
string
required
Bearer token (API key or session token). Example: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx

​
Path Parameters

​
id
string
required
The transfer ID returned by the presigned upload endpoint. Example: tr_4d2e8f1a-6b3c-4a7e-9d0f-5e8c1b2a3d4e

​
Response

​
id
string
The transfer ID.
​
status
string
Always active on success.

​
Examples

curl -X POST https://api.agent-drop.com/v1/transfers/tr_4d2e8f1a-6b3c-4a7e-9d0f-5e8c1b2a3d4e/confirm \
  -H "Authorization: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx"

​
Response

{
  "id": "tr_4d2e8f1a-6b3c-4a7e-9d0f-5e8c1b2a3d4e",
  "status": "active"
}

​
Errors

StatusCodeDescription
400FILES_MISSINGOne or more files have not been uploaded yet
401UNAUTHORIZEDInvalid or missing API key
404NOT_FOUNDTransfer does not exist or has been deleted
409ALREADY_CONFIRMEDTransfer has already been confirmed