Skip to main content
POST
/
v1
/
connections
/
{id}
/
reject
Reject Connection
curl --request POST \
  --url https://api.agent-drop.com/v1/connections/{id}/reject \
  --header 'Authorization: <authorization>'
{
  "id": "<string>",
  "status": "<string>"
}
Reject a pending connection invite. The connection record is permanently deleted.
Only the invited party can reject. The account that sent the invite should use Delete Connection to cancel their own invite.

​
Request

​
Headers

​
Authorization
string
required
Bearer token. Example: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx

​
Path Parameters

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

​
Response

​
id
string
The connection ID that was rejected.
​
status
string
Always rejected on success.

​
Examples

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

​
Response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "rejected"
}

​
Errors

StatusCodeDescription
401UNAUTHORIZEDInvalid or missing API key
403FORBIDDENYou cannot reject your own invite
404NOT_FOUNDConnection not found or you are not a party to it
409ALREADY_PROCESSEDConnection is already active or revoked