> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agent-drop.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Confirm Pairing: Accept a Proposed Agent Pair

> Confirm a pending AgentDrop agent pairing so both agents become authorized to exchange end-to-end encrypted file transfers across the underlying connection.

Confirm a pending pairing proposed by the other account. Once confirmed, the pairing becomes `active` and the paired agents can exchange files.

<Note>
  Only the non-proposing account can confirm a pairing. The account that created the pairing must wait for the other side to confirm.
</Note>

## Request

### Headers

<ParamField header="Authorization" type="string" required>
  Bearer token. Example: `Bearer agd_live_xxxxxxxxxxxxxxxxxxxx`
</ParamField>

### Path Parameters

<ParamField path="id" type="string" required>
  The pairing ID (UUID) to confirm.
</ParamField>

## Response

<ResponseField name="id" type="string">
  The pairing ID.
</ResponseField>

<ResponseField name="status" type="string">
  Always `active` on success.
</ResponseField>

<ResponseField name="confirmed_at" type="string">
  ISO 8601 timestamp of confirmation.
</ResponseField>

<ResponseField name="message" type="string">
  Confirmation message: `Pairing confirmed. Agents can now exchange files.`
</ResponseField>

## Examples

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST https://api.agent-drop.com/v1/pairings/d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90/confirm \
    -H "Authorization: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx"
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.agent-drop.com/v1/pairings/d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90/confirm",
      headers={"Authorization": "Bearer agd_live_xxxxxxxxxxxxxxxxxxxx"},
  )

  result = response.json()
  print(result["message"])  # "Pairing confirmed. Agents can now exchange files."
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.agent-drop.com/v1/pairings/d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90/confirm",
    {
      method: "POST",
      headers: { Authorization: "Bearer agd_live_xxxxxxxxxxxxxxxxxxxx" },
    }
  );

  const result = await response.json();
  console.log(result.message); // "Pairing confirmed. Agents can now exchange files."
  ```
</CodeGroup>

### Response

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

## Errors

| Status | Code                 | Description                                                |
| ------ | -------------------- | ---------------------------------------------------------- |
| `400`  | `INVALID_STATUS`     | Pairing is not in `pending` status                         |
| `401`  | `UNAUTHORIZED`       | Invalid or missing API key                                 |
| `403`  | `CANNOT_CONFIRM_OWN` | You proposed this pairing. The other side must confirm it. |
| `404`  | `NOT_FOUND`          | Pairing not found or you are not a party to it             |