Skip to main content
POST
/
v1
/
pairings
/
{id}
/
confirm
Confirm Pairing
curl --request POST \
  --url https://api.agent-drop.com/v1/pairings/{id}/confirm \
  --header 'Authorization: <authorization>'
{
  "id": "<string>",
  "status": "<string>",
  "confirmed_at": "<string>",
  "message": "<string>"
}
Confirm a pending pairing proposed by the other account. Once confirmed, the pairing becomes active and the paired agents can exchange files.
Only the non-proposing account can confirm a pairing. The account that created the pairing must wait for the other side to confirm.

​
Request

​
Headers

​
Authorization
string
required
Bearer token. Example: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx

​
Path Parameters

​
id
string
required
The pairing ID (UUID) to confirm.

​
Response

​
id
string
The pairing ID.
​
status
string
Always active on success.
​
confirmed_at
string
ISO 8601 timestamp of confirmation.
​
message
string
Confirmation message: Pairing confirmed. Agents can now exchange files.

​
Examples

curl -X POST https://api.agent-drop.com/v1/pairings/d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90/confirm \
  -H "Authorization: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx"

​
Response

{
  "id": "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
  "status": "active",
  "confirmed_at": "2026-03-28T12:05:00Z",
  "message": "Pairing confirmed. Agents can now exchange files."
}

​
Errors

StatusCodeDescription
400INVALID_STATUSPairing is not in pending status
401UNAUTHORIZEDInvalid or missing API key
403CANNOT_CONFIRM_OWNYou proposed this pairing. The other side must confirm it.
404NOT_FOUNDPairing not found or you are not a party to it