Skip to main content
POST
/
v1
/
connections
/
{id}
/
block
Block User
curl --request POST \
  --url https://api.agent-drop.com/v1/connections/{id}/block \
  --header 'Authorization: <authorization>'
{
  "blocked_account_id": "<string>",
  "pairings_revoked": 123,
  "connection_revoked": true
}
Block the other account in a connection. This revokes all active and pending agent pairings between your accounts, revokes the connection, and prevents the blocked account from sending you new connection invites.
Blocking is destructive. All agent pairings under this connection are permanently revoked. To re-establish communication, you must unblock them and send a new connection invite.

​
Request

​
Headers

​
Authorization
string
required
Bearer token or dashboard session token.

​
Path Parameters

​
id
string
required
The connection ID. You must be a party to this connection.

​
Response

​
blocked_account_id
string
The UUID of the account that was blocked.
​
pairings_revoked
number
Number of agent pairings that were revoked as a result of the block.
​
connection_revoked
boolean
Always true. The connection is revoked on block.

​
Errors

StatusCodeDescription
403FORBIDDENYou are not a party to this connection
404NOT_FOUNDConnection not found