---
title: "Excluir coleção de faces"
method: POST
path: "/colecao/deletar"
tags: ["Biometria Facial 1:N"]
---

# Excluir coleção de faces

`POST /colecao/deletar`

### Descrição

A **exclusão de uma coleção de faces** remove permanentemente um agrupamento previamente criado na **Biometria Facial 1:N** do **BigID**, independentemente de conter faces associadas ou não. Essa operação deve ser utilizada quando a coleção não for mais necessária para buscas por similaridade (1:N) ou fluxos de autenticação biométrica.

Ao excluir uma coleção, **todas as representações faciais criptografadas** vinculadas a ela são removidas de forma definitiva e **não podem ser recuperadas**, garantindo controle total sobre o ciclo de vida dos dados biométricos armazenados.

Para mais informações sobre casos de uso, principais dúvidas e orientações de aplicação, acesse [Biometria Facial](/docs/biometria-facialfacematch).

### Tabela de preços

A cobrança é realizada conforme o volume mensal de operações, de acordo com a tabela abaixo:

| Operações realizadas no mês | Valor por operação |
|:---------------------------:|:------------------:|
| 1 – 10.000 | R$ 0,170 |
| 10.001 – 50.000 | R$ 0,162 |
| 50.001 – 100.000 | R$ 0,153 |
| 100.001 – 500.000 | R$ 0,146 |
| 500.001 – 1.000.000 | R$ 0,138 |
| 1.000.001 – 5.000.000 | R$ 150.000,00 (preço fixo) |
| Acima de 5.000.000 | [Entre em contato](mailto:comercial@bigdatacorp.com.br) |

## Request body

- DeleteCollectionRequest — Objeto de request para exclusão de coleção da Biometria Facial 1:N.
  - `collection` string, required — Identificador único da coleção a ser excluída.

## Response `200`

Resultado da exclusão da coleção.

- OperationResult — Estrutura padrão de retorno de operações do BigID.
  - `ticketId` string — Identificador da operação.
  - `resultCode` integer — Código de resultado.
  - `success` boolean — Indica se a operação foi bem-sucedida.
  - `message` string — Mensagem de resultado.

---

[API](https://skmtc.dev/bigdatacorp/apis/bigid.md) · [All operations](https://skmtc.dev/bigdatacorp/apis/bigid/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bigdatacorp/bigid/revisions/74abe72d7efc/schema)
