> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-pt-br/api-rest/identity-api/identity-api-reference/authentication/delete-users.md).

# Excluir usuários

Permite a exclusão em lote de usuários registrados no sistema de autenticação.

### Endpoint

```
DELETE /services/authenticateUser
```

### Cabeçalhos

| Nome          | Tipo   | Obrigatório | Descrição                                                       |
| ------------- | ------ | ----------- | --------------------------------------------------------------- |
| **x-api-key** | string | **Sim**     | API Key de autorização de acesso.                               |
| **family**    | string | Não         | Valor: **Authentication**. Requerido com o serviço de Tracking. |

{% hint style="info" %}
Todas as chamadas aos Endpoints para Tracking com **Identity Platform** devem conter o header `family`.
{% endhint %}

### Corpo da solicitação

**Content-Type:** `application/json`

#### Parâmetros

| Parâmetro | Tipo      | Obrigatório | Descrição                                                       |
| --------- | --------- | ----------- | --------------------------------------------------------------- |
| `userIds` | string\[] | **Sim**     | Lista de identificadores únicos dos usuários a serem excluídos. |

#### Exemplo de solicitação

```json
{
  "userIds": ["001"]
}
```

### Respostas

#### `200` Sucesso

#### Parâmetros de resposta

| Parâmetro           | Tipo    | Descrição                                                                                                       |
| ------------------- | ------- | --------------------------------------------------------------------------------------------------------------- |
| `serviceResultCode` | integer | Código que indica o **resultado geral** da execução do serviço. Ver [Service Result Code](#service-result-code) |
| `serviceResultLog`  | string  | Campo descritivo do resultado da execução do serviço. Inclui detalhes quando há um erro ou exceção.             |
| `timestamp`         | string  | Carimbo de data e hora (UTC) da resposta no formato YYYY-MM-DDThh:flag\_mm:ssZ                                  |
| `transactionId`     | string  | Identificador de transação associado à solicitação processada pela API.                                         |

#### Service Result Code

O `serviceResultCode` indica o resultado geral da execução do serviço:

| serviceResultCode | Descrição                                                                              | Código HTTP |
| ----------------- | -------------------------------------------------------------------------------------- | ----------- |
| 0                 | A execução do serviço foi bem-sucedida, o módulo processou a solicitação corretamente. | 200         |

#### Exemplo de resposta

```json
{
  "serviceResultCode": 0,
  "serviceResultLog": "Service request successfully processed",
  "timestamp": "2024-10-29T20:29:24Z",
  "transactionId": "531ecbb1-de3d-4907-a737-0db236674e9a"
}
```

#### `400` Bad Request

```json
{
  "status": 400,
  "title": "Requisição inválida",
  "detail": "Solicitação inválida.",
  "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400",
  "errors": []
}
```

#### `401` Não autorizado

```json
{
  "message": "Não autorizado"
}
```

#### `403` Proibido

```json
{
  "Message": "O usuário não está autorizado a acessar este recurso com uma negação explícita"
}
```

#### `502` Bad Gateway

```json
{
  "status": 502,
  "title": "Gateway inválido",
  "detail": "O servidor recebeu uma resposta inválida.",
  "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/502"
}
```

#### `504` Gateway Timeout

```json
{
  "message": "A requisição do Endpoint excedeu o tempo limite"
}
```