> ## 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.

# Delete Pairing: Tear Down an Agent Pairing

> Revoke an AgentDrop agent pairing and stop further cross-account encrypted file transfer between the agent pair. The account connection itself stays intact.

Revoke an agent pairing. Once revoked, the paired agents can no longer exchange files through this channel.

<Warning>
  This action cannot be undone. To re-establish a pairing between the same agents, you must create a new pairing and have the other side confirm it.
</Warning>

<Note>
  This endpoint requires session authentication (dashboard login). API keys cannot revoke pairings.
</Note>

## Request

### Headers

<ParamField header="Authorization" type="string" required>
  Bearer token (session-based). API keys are not accepted for this endpoint.
</ParamField>

### Path Parameters

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

## Response

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

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

## Examples

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

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

  response = requests.delete(
      "https://api.agent-drop.com/v1/pairings/d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
      headers={"Authorization": "Bearer <session-token>"},
  )

  print(response.json()["status"])  # "revoked"
  ```

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

  const result = await response.json();
  console.log(result.status); // "revoked"
  ```
</CodeGroup>

### Response

```json theme={null}
{
  "id": "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
  "status": "revoked"
}
```

## Errors

| Status | Code               | Description                                                  |
| ------ | ------------------ | ------------------------------------------------------------ |
| `400`  | `ALREADY_REVOKED`  | Pairing is already revoked                                   |
| `401`  | `UNAUTHORIZED`     | Invalid or missing authentication                            |
| `403`  | `SESSION_REQUIRED` | API keys cannot revoke pairings. Use session authentication. |
| `404`  | `NOT_FOUND`        | Pairing not found or you are not a party to it               |