> ## 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.

# Anexar documento à assinatura incremental

> Anexa ao rascunho um PDF que já chega assinado, conferindo se ele aceita assinatura nova.

Anexa um documento por chamada, em base64 ou por URL. O arquivo é guardado como chegou, sem conversão. Aqui o documento é conferido: certificado como "nenhuma alteração permitida" (DocMDP `/P 1`) é recusado na hora. Não muda o estado do rascunho: depois de anexar, chame [`advance`](https://docs-platform.services-valid.com.br/plataforma/assinatura-digital/api/post-incremental-advance).

## Parâmetros

**uuid** `string` *required*

UUID da assinatura incremental em rascunho.

**filename** `string` *required*

Nome do arquivo, ex.: `"ccb-assinada-pela-credora.pdf"`.

**content** `string`

O PDF em base64, sem o prefixo `data:`. Alternativa a `url`.

**url** `string`

URL pública do PDF. Alternativa a `content`.

## Respostas

**fileUuid** `string`

Identificador do documento. Use-o nas rotas de posição.

**filename** `string`

Nome do arquivo.

**sizeBytes** `integer`

Tamanho, em bytes.

**sha256** `string`

SHA-256 do arquivo recebido.

**receivedSignatures** `array`

As assinaturas com que o documento chegou, cada uma com `signerName` (titular do certificado, sem CPF ou CNPJ, ou `null`) e `signedAt`. `null` se o documento chegou sem assinatura. No modo incremental elas continuam no mesmo arquivo.

## Erros

Veja [Autenticação e erros](https://docs-platform.services-valid.com.br/plataforma/assinatura-digital/api/erros-e-autenticacao.md).

* **400**: Sem `content` nem `url`, ou PDF ilegível.
* **404**: Não existe assinatura incremental com este uuid no seu projeto. Um envelope comum também responde 404 aqui: ele se edita pelas rotas de [`/signer/v1/envelopes`](https://docs-platform.services-valid.com.br/plataforma/assinatura-digital/api/post-envelope-draft).
* **422**: O documento não aceita assinatura nova: certificado como "nenhuma alteração permitida", protegido por senha ou com estrutura que impede a revisão incremental.

```json theme={"theme":"catppuccin-latte"}
HTTP/1.1 201 Created
Content-Type: application/json

{
  "fileUuid": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
  "filename": "ccb-assinada-pela-credora.pdf",
  "sizeBytes": 248512,
  "sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
  "receivedSignatures": [
    { "signerName": "EMPRESA CREDORA S.A.", "signedAt": "2026-11-10T14:02:11.000Z" }
  ]
}
```

## Exemplo

```bash theme={"theme":"catppuccin-latte"}
curl -X POST "https://api.valid.com/signer/v1/incremental-signatures/550e8400-e29b-41d4-a716-446655440000/documents" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filename": "ccb-assinada-pela-credora.pdf", "url": "https://exemplo.com/ccb.pdf"}'
```


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