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

# Remover documento do envelope

> Remove (soft-delete) um documento anexado ao envelope em rascunho.

Remove um documento anexado a um envelope em rascunho. A remoção é um soft-delete — o arquivo não é imediatamente apagado do armazenamento, mas é marcado como deletado e não aparece mais no envelope.

**Autenticação**: `x-api-key` no header. Também aceita `Authorization: Bearer` com headers de projeto/organização.

## Parâmetros

<ParamField path="uuid" type="string" required>
  UUID do envelope.
</ParamField>

<ParamField path="fileUuid" type="string" required>
  UUID do documento a remover.
</ParamField>

## Respostas

Resposta vazia com status **204 No Content**.

## Erros

Veja [Autenticação e erros](/plataforma/assinatura-digital/api/erros-e-autenticacao).

* **404**: Envelope ou documento não encontrado, ou não pertence ao seu projeto.
* **409**: Envelope não está em rascunho.

<ResponseExample>
  ```
  HTTP/1.1 204 No Content
  ```

  ```json theme={"theme":"catppuccin-latte"}
  HTTP/1.1 404 Not Found
  Content-Type: application/json

  {
    "statusCode": 404,
    "message": "Document not found"
  }
  ```
</ResponseExample>

## Exemplo

```bash theme={"theme":"catppuccin-latte"}
curl -X DELETE "https://api.valid.com/signer/v1/envelopes/550e8400-e29b-41d4-a716-446655440000/documents/6ba7b811-9dad-11d1-80b4-00c04fd430c8" \
  -H "x-api-key: YOUR_API_KEY"
```

## Importante

* **Soft-delete**: o arquivo não é removido imediatamente do armazenamento (isto é um detalhe de implementação). O que importa é que deixa de aparecer no envelope.
* **Sem mudança de estado**: remover um documento não muda o estado do envelope.
* **Só em rascunho**: depois que o envelope é enviado, não é possível remover documentos.

## Relacionado

* [`POST .../:uuid/documents`](/plataforma/assinatura-digital/api/post-envelope-document) — anexar documento
* [`GET /signer/v1/envelopes/:uuid`](/plataforma/assinatura-digital/api/get-envelope-by-id) — listar documentos atuais


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