Skip to main content
POST
/
v1
/
agents
/
{id}
/
disconnect
Disconnect Agent
curl --request POST \
  --url https://api.agent-drop.com/v1/agents/{id}/disconnect \
  --header 'Authorization: <authorization>'
{
  "agent_id": "<string>",
  "status": "<string>",
  "message": "<string>"
}
Disconnect an agent from your account. This wipes the agent’s encryption keys and revokes all active channels. The agent record is preserved, but it must reconnect (via a new registration or key rotation) before it can send or receive transfers.

​
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

​
agent_id
string
The agent’s slug identifier.
​
status
string
Always disconnected on success.
​
message
string
Confirmation message.

​
Examples

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

​
Response

{
  "agent_id": "data-pipeline",
  "status": "disconnected",
  "message": "Agent disconnected. Encryption keys have been wiped."
}

​
Errors

StatusCodeDescription
401UNAUTHORIZEDInvalid or missing API key
403FORBIDDENYou do not own this agent
404NOT_FOUNDAgent UUID does not exist
409ALREADY_DISCONNECTEDAgent is already disconnected