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

# Clear Face

> Remove a face exclusion for a session

```
DELETE /v1/igaming/self-exclusion/face/{session_id}
```

Removes a face exclusion previously set via [Exclude Face](/api-reference/igaming/exclude-face) or [Exclude Applicant](/api-reference/igaming/exclude-applicant). This call is idempotent — clearing a face that isn't excluded returns a normal `200` with `unexcluded: false`, not an error.

## Request

### Path parameters

| Parameter    | Type   | Required | Description                               |
| ------------ | ------ | -------- | ----------------------------------------- |
| `session_id` | string | Yes      | The session whose face exclusion to clear |

### Headers

| Header      | Required | Description  |
| ----------- | -------- | ------------ |
| `x-api-key` | Yes      | Your API key |

### Example request

<CodeGroup>
  ```bash cURL theme={null}
  curl -X DELETE https://api.deepidv.com/v1/igaming/self-exclusion/face/b8991ba9-2566-4fe5-b758-66f387c3e28b \
    -H "x-api-key: YOUR_API_KEY"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.deepidv.com/v1/igaming/self-exclusion/face/b8991ba9-2566-4fe5-b758-66f387c3e28b",
    {
      method: "DELETE",
      headers: { "x-api-key": "YOUR_API_KEY" },
    }
  );

  const data = await response.json();
  ```

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

  response = requests.delete(
      "https://api.deepidv.com/v1/igaming/self-exclusion/face/b8991ba9-2566-4fe5-b758-66f387c3e28b",
      headers={"x-api-key": "YOUR_API_KEY"},
  )
  ```
</CodeGroup>

## Response

### 200 — Success

| Field                | Type    | Description                                                                         |
| -------------------- | ------- | ----------------------------------------------------------------------------------- |
| `unexcluded`         | boolean | `false` if there was no enrolled face exclusion to clear — idempotent, not an error |
| `matched_session_id` | string  | Present when the clear was applied via the matched enrollment                       |

### Error responses

| Status                      | Description                       |
| --------------------------- | --------------------------------- |
| `400 Bad Request`           | Missing or malformed `session_id` |
| `401 Unauthorized`          | Invalid or revoked API key        |
| `403 Forbidden`             | `x-api-key` header missing        |
| `500 Internal Server Error` | Unexpected server error           |

<ResponseExample>
  ```json 200 theme={null}
  {
    "unexcluded": true
  }
  ```
</ResponseExample>
