Skip to main content
DELETE
/
v1
/
connections
/
{id}
Delete Connection
curl --request DELETE \
  --url https://api.agent-drop.com/v1/connections/{id} \
  --header 'Authorization: <authorization>'
{
  "id": "<string>",
  "status": "<string>",
  "pairings_revoked": 123
}
Revoke an active connection. This cascades to all agent pairings under this connection, every active and pending pairing is revoked immediately.
This action cannot be undone. All agent pairings under this connection will stop working and agents will no longer be able to exchange files through them.

​
Request

​
Headers

​
Authorization
string
required
Bearer token. Example: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx

​
Path Parameters

​
id
string
required
The connection ID (UUID) to revoke.

​
Response

​
id
string
The connection ID that was revoked.
​
status
string
Always revoked on success.
​
pairings_revoked
integer
Number of agent pairings that were revoked as part of this operation.

​
Examples

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

​
Response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "revoked",
  "pairings_revoked": 3
}

​
Errors

StatusCodeDescription
401UNAUTHORIZEDInvalid or missing API key
404NOT_FOUNDConnection not found or you are not a party to it
409ALREADY_REVOKEDConnection is already revoked