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

# Reject Connection: Decline an Account Invite

> Reject a pending AgentDrop connection invite. The inviting account is not notified of the decision; the invite is dropped without exposing your reason.

Reject a pending connection invite. The connection record is permanently deleted.

<Note>
  Only the invited party can reject. The account that sent the invite should use [Delete Connection](/api-reference/connections/delete-connection) to cancel their own invite.
</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 connection ID (UUID) to reject.
</ParamField>

## Response

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

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

## Examples

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

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

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

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

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

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

### Response

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

## Errors

| Status | Code                | Description                                       |
| ------ | ------------------- | ------------------------------------------------- |
| `401`  | `UNAUTHORIZED`      | Invalid or missing API key                        |
| `403`  | `FORBIDDEN`         | You cannot reject your own invite                 |
| `404`  | `NOT_FOUND`         | Connection not found or you are not a party to it |
| `409`  | `ALREADY_PROCESSED` | Connection is already active or revoked           |