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

# Eliminar documento

> Eliminar um documento que carregaste, juntamente com os seus resultados extraídos

Elimina um documento que carregaste com [Carregar documento](https://docs.anivahealth.com/pt/api/documents/upload-document.md). Usa-o quando
carregaste um ficheiro para o perfil errado. A Aniva elimina o ficheiro e todos os valores extraídos dele.
Os valores também desaparecem da app Aniva do membro.

Requer o âmbito `documents_upload` no grupo de perfis em que o documento foi carregado.

De seguida, a Aniva envia o [webhook](https://docs.anivahealth.com/pt/concepts/webhooks.md) `document.deleted` para os endpoints que receberam
o último evento de resultados do documento. Uma eliminação não pode ser anulada.

## Pedido

### Parâmetros de caminho

**id** `string` *required*

ID do documento (UUID) da resposta de carregamento.

## Resposta

Em caso de sucesso, a API devolve `200 OK`.

**id** `string` *required*

O documento eliminado.

**deleted** `boolean` *required*

Sempre `true`.

## Respostas de erro

| Estado | Descrição |
| - | - |
| `400` | Formato de ID inválido. |
| `403` | A tua chave de API não tem o âmbito `documents_upload`. |
| `404` | Nenhum documento carregado num dos teus grupos de perfis tem este ID. |
| `500` | Erro interno do servidor. |

```bash cURL theme={null}
curl --request DELETE \
  --url https://anivahealth.com/api/v1/documents/f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
{
  "id": "f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c",
  "deleted": true
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.