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

# Deletar documento

> Deletar um documento de uma base de conhecimento

Este endpoint deleta permanentemente um documento de uma base de conhecimento. Os embeddings vetoriais do documento também são removidos do banco de dados vetorial.

### Parâmetros de Caminho

<ParamField path="knowledgebaseId" type="integer" required>
  O identificador único da base de conhecimento
</ParamField>

<ParamField path="documentId" type="integer" required>
  O identificador único do documento a ser deletado
</ParamField>

### Resposta

<ResponseField name="message" type="string">
  Mensagem de sucesso
</ResponseField>

<ResponseExample>
  ```json 200 Response theme={null}
  {
    "message": "Documento deletado com sucesso."
  }
  ```

  ```json 404 Knowledgebase Not Found theme={null}
  {
    "error": "Base de conhecimento não encontrada."
  }
  ```

  ```json 404 Document Not Found theme={null}
  {
    "error": "Documento não encontrado."
  }
  ```

  ```json 500 Error theme={null}
  {
    "error": "Falha ao deletar documento. Tente novamente."
  }
  ```
</ResponseExample>

### O Que É Deletado

Quando você deleta um documento:

* **Registro do documento** é removido do banco de dados
* **Embeddings vetoriais** são deletados do banco de dados vetorial
* **Conteúdo processado** é removido dos armazenamentos de documentos externos
* **Status da base de conhecimento pai** é atualizado automaticamente

<Warning>
  Esta ação é irreversível. O documento e todo seu conteúdo processado serão permanentemente deletados.
</Warning>

<Note>
  Se este foi o último documento na base de conhecimento, o status da base de conhecimento mudará para `empty`.
</Note>