> For the complete documentation index, see [llms.txt](https://docs.autentique.com.br/api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.autentique.com.br/api/2/mutations/removendo-um-documento.md).

# Removendo um Documento

Para excluir um documento, deve-se utilizar a seguinte *mutation*:

```graphql
mutation {
  deleteDocument(id: "ID_DO_DOCUMENTO")
}
```

**Parâmetros:**

* `id`: String (UUID!) que representa o identificador único do documento que você deseja excluir.
* `folder_id` *(opcional)*: String (UUID) que representa o identificador da pasta cujas assinaturas do documento também devem ser removidas. Quando informado, todas as assinaturas do documento pertencentes à pasta indicada serão excluídas juntamente com o documento.

#### Resposta esperada:

```graphql
{
  "data": {
    "deleteDocument": true
  }
}
```

***

#### Comportamento em pastas

Por padrão, a exclusão do documento remove apenas a assinatura correspondente ao contexto da requisição.

Ao informar o parâmetro `folder_id`, todas as assinaturas do documento que pertencem à pasta informada também serão removidas.

Exemplo:

* Documento com 4 assinaturas.
* 3 assinaturas estão na pasta `A`.
* 1 assinatura não pertence a nenhuma pasta.

Executando:

```graphql
mutation {
  deleteDocument(
    id: "ID_DO_DOCUMENTO"
    folder_id: "ID_DA_PASTA_A"
  )
}
```

Resultado:

* As 3 assinaturas da pasta `A` são removidas.
* A assinatura que não pertence à pasta permanece inalterada.

***

{% hint style="danger" %}
IMPORTANTE: A *mutation* de deletar documentos possui a mesma funcionalidade de exclusão que o painel, e NÃO bloqueia o documento, ou seja, caso o documento já tenha sido assinado por alguma das partes, ele será apenas movido para a lixeira do usuário que realizou o request. Nesses casos, é recomendado realizar uma requisição de atualizar documento e informar o campo \`deadline\_at\` para o momento atual, assim bloqueando o documento.
{% endhint %}

{% hint style="info" %}
Você pode conferir o que é cada um desses parâmetros direto na documentação completa da API GraphQL, no menu Docs do [Altair](https://altair.autentique.com.br). Se você não sabe como fazer isso, confira o nosso tutorial em [Usando o Altair](/api/2/integracao/altair.md).
{% endhint %}

{% hint style="info" %}
Se o Altair não te ajuda para integrar com a API, confira alguns exemplos de como fazer essas requisições de outra forma: <https://graphql.org/graphql-js/graphql-clients/>
{% endhint %}