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
Bearer token. Example: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx
Path Parameters
The agent’s UUID. Example: 550e8400-e29b-41d4-a716-446655440000
Response
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
| Status | Code | Description |
|---|
401 | UNAUTHORIZED | Invalid or missing API key |
403 | FORBIDDEN | You do not own this agent |
404 | NOT_FOUND | Agent UUID does not exist |