> 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/midapi-v2/face-collections/delete-collection.md).

# Excluir coleção

Serviço que exclui uma coleção facial e os rostos registrados nela.

### Endpoint

```
DELETE /biometric/face/collections/{collectionId}
```

### Cabeçalhos

| Nome              | Tipo   | Obrigatório | Descrição                                                                                                                   |
| ----------------- | ------ | ----------- | --------------------------------------------------------------------------------------------------------------------------- |
| **Authorization** | string | **Sim**     | Token de consumer no formato `Bearer <token>`. Ver [Autenticação](/docs.facephi-pt-br/api-rest/midapi-v2/autenticacion.md). |
| **consumer-id**   | string | **Sim**     | Identificador do consumer.                                                                                                  |

### Parâmetros de rota

| Parâmetro      | Tipo   | Obrigatório | Descrição                 |
| -------------- | ------ | ----------- | ------------------------- |
| `collectionId` | string | **Sim**     | Identificador da coleção. |

### Respostas

#### `204` Sem conteúdo

A coleção foi excluída com sucesso. A resposta não contém corpo.

#### Outras respostas

| Código | Descrição                                                               |
| ------ | ----------------------------------------------------------------------- |
| `401`  | Token ausente, inválido ou expirado.                                    |
| `403`  | O consumer não está provisionado com o serviço `FACE_COLLECTION_ADMIN`. |

O corpo de uma resposta de erro tem o formato descrito em [MIDAPI v2](/docs.facephi-pt-br/api-rest/midapi-v2.md#respuestas-de-error).