Skip to main content
DELETE
/
v1
/
agents
/
{id}
Delete Agent
curl --request DELETE \
  --url https://api.agent-drop.com/v1/agents/{id} \
  --header 'Authorization: <authorization>'
{
  "message": "<string>"
}
Permanently delete an agent and all associated data, including encryption keys and pending transfers.
This action is irreversible. All encryption keys, connection tokens, and transfer history for this agent will be permanently removed.

Request

Headers

Authorization
string
required
Bearer token. Example: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx

Path Parameters

id
string
required
The agent’s UUID. Example: 550e8400-e29b-41d4-a716-446655440000

Response

message
string
Confirmation message.

Examples

curl -X DELETE https://api.agent-drop.com/v1/agents/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx"

Response

{
  "message": "Agent deleted"
}

Errors

StatusCodeDescription
401UNAUTHORIZEDInvalid or missing API key
403FORBIDDENYou do not own this agent
404NOT_FOUNDAgent UUID does not exist