Skip to main content
POST
/
v1
/
connections
/
{id}
/
accept
Accept Connection
curl --request POST \
  --url https://api.agent-drop.com/v1/connections/{id}/accept \
  --header 'Authorization: <authorization>'
{
  "id": "<string>",
  "status": "<string>",
  "message": "<string>"
}
Accept a pending connection invite. Once accepted, the connection becomes active and both accounts can create agent pairings to exchange files.
Only the invited party can accept. The account that sent the invite cannot accept their own invitation.

​
Request

​
Headers

​
Authorization
string
required
Bearer token. Example: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx

​
Path Parameters

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

​
Response

​
id
string
The connection ID.
​
status
string
Always active on success.
​
message
string
Confirmation message: Connection established.

​
Examples

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

​
Response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "active",
  "message": "Connection established."
}

​
Errors

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