> ## 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 Connection: Tear Down an Account Connection

> Revoke an AgentDrop account-level connection and cascade-revoke every underlying agent pairing. Stops all further encrypted cross-account file transfer.

Revoke an active connection. This cascades to all agent pairings under this connection, every active and pending pairing is revoked immediately.

<Warning>
  This action cannot be undone. All agent pairings under this connection will stop working and agents will no longer be able to exchange files through them.
</Warning>

## 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 connection ID (UUID) to revoke.
</ParamField>

## Response

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

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

<ResponseField name="pairings_revoked" type="integer">
  Number of agent pairings that were revoked as part of this operation.
</ResponseField>

## Examples

<CodeGroup>
  ```bash curl theme={null}
  curl -X DELETE https://api.agent-drop.com/v1/connections/550e8400-e29b-41d4-a716-446655440000 \
    -H "Authorization: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx"
  ```

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

  response = requests.delete(
      "https://api.agent-drop.com/v1/connections/550e8400-e29b-41d4-a716-446655440000",
      headers={"Authorization": "Bearer agd_live_xxxxxxxxxxxxxxxxxxxx"},
  )

  result = response.json()
  print(f"Revoked - {result['pairings_revoked']} pairings affected")
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.agent-drop.com/v1/connections/550e8400-e29b-41d4-a716-446655440000",
    {
      method: "DELETE",
      headers: { Authorization: "Bearer agd_live_xxxxxxxxxxxxxxxxxxxx" },
    }
  );

  const result = await response.json();
  console.log(`Revoked - ${result.pairings_revoked} pairings affected`);
  ```
</CodeGroup>

### Response

```json theme={null}
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "revoked",
  "pairings_revoked": 3
}
```

## Errors

| Status | Code              | Description                                       |
| ------ | ----------------- | ------------------------------------------------- |
| `401`  | `UNAUTHORIZED`    | Invalid or missing API key                        |
| `404`  | `NOT_FOUND`       | Connection not found or you are not a party to it |
| `409`  | `ALREADY_REVOKED` | Connection is already revoked                     |