---
title: "Apagar o enrollment biométrico"
method: DELETE
path: "/v1/users/{userExternalId}/enrollment"
tags: ["Users"]
---

# Apagar o enrollment biométrico

`DELETE /v1/users/{userExternalId}/enrollment`

## Request

- Base URL: `https://api.signdocs.com.br`
- URL: `https://api.signdocs.com.br/v1/users/{userExternalId}/enrollment`
- Auth: HTTP bearer

Elimina a imagem de referência, a imagem original do documento quando o
cadastro veio de uma, e o registro do enrollment.

Existe para atender o direito de eliminação (LGPD art. 18): um
funcionário que sai da empresa não deveria esperar os 90 dias de
retenção para a face dele desaparecer.

Os objetos no S3 são removidos antes do registro, e cada remoção é
gravada no log de acesso biométrico — essa entrada é a evidência de que
o apagamento aconteceu.

**Transações em andamento que dependiam desse enrollment passam a falhar
a etapa de comparação com 422.** É a consequência esperada de um pedido
de eliminação.

Requer scope `transactions:write`.

## Path parameters

- `userExternalId` string, required

## Response `200`

Enrollment apagado.

- object
  - `userExternalId` string
  - `deleted` boolean
  - `deletedAt` string, date-time
  - `enrollmentVersion` integer: Versão que existia no momento do apagamento.
  - `objectsDeleted` integer: Quantos objetos foram removidos (1, ou 2 com documento).
  - `versionsDeleted` integer: Quantas versões foram destruídas. O bucket é versionado, e um DeleteObject comum só cria um marcador — os bytes continuariam recuperáveis por version id. Este número conta as versões efetivamente apagadas, e é o que comprova a eliminação.

## Other responses

- `401`: Autenticação ausente ou inválida.
- `403`: Permissões insuficientes para a operação solicitada. Inclui `purpose: "ACTION_AUTHENTICATION"` sem `featureFlags.trustSessionsEnabled`. A verificação é pelo `purpose`, não pela rota: vale em `/v1/transactions`, `/v1/signing-sessions` e `/v1/envelopes/{envelopeId}/sessions`, além de `/v1/trust-sessions`. O remédio é habilitar a flag para o tenant e provisionar a cota `monthlyTrustSessions`.
- `404`: Recurso não encontrado.
- `500`: Erro interno do servidor.

---

[API](https://skmtc.dev/signdocs/apis/signdocs-brasil-external-api.md) · [All operations](https://skmtc.dev/signdocs/apis/signdocs-brasil-external-api/llms.txt) · [OpenAPI document](https://skmtc.dev/signdocs/apis/signdocs-brasil-external-api/revisions/2d3805aed161?raw)