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

# Definir signatários da assinatura incremental

> Substitui a lista de signatários de uma assinatura incremental em rascunho, com o tipo de assinatura de cada um.

Define a lista completa de signatários. A chamada **substitui** a lista anterior inteira, e com ela o modo de posicionamento e as posições já marcadas. Todos entram com a chancela posicionada pelo próprio signatário (`SIGNER`); troque no passo seguinte com [`placement-mode`](https://docs-platform.services-valid.com.br/plataforma/assinatura-digital/api/put-incremental-signer-placement-mode). Não muda o estado do rascunho: depois, 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.

**signers** `array` *required*

Signatários, ao menos um. Cada item:

* `name` (string, obrigatório): nome completo.
* `email` (string, obrigatório): e-mail.
* `cpf` (string, obrigatório): CPF, com ou sem máscara.
* `signatureType` (enum): `ICP_BRASIL`, `MFA_EMAIL`, `MFA_SMS`, `LIVENESS`, `MFA_EMAIL_LIVENESS` ou `MFA_SMS_LIVENESS`. Padrão: `ICP_BRASIL`.
* `qualification` (string): qualificação, ex.: `"Contratante"`.
* `birthDate` (string): data de nascimento, `AAAA-MM-DD`.
* `phoneCountryCode` (string): DDI, ex.: `"55"`.
* `phoneNumber` (string): celular com DDD. Obrigatório nos tipos por SMS.
* `queueOrder` (integer): ordem na fila. Padrão: a posição na lista, a partir de 1.
* `liveness` (object): prova de vida já feita, com `sessionId` (sessão do Hub de Liveness) e/ou `imageBase64` (foto feita no seu sistema, JPEG ou PNG, até 5 MB). Com ela, o link de assinatura não pede a captura de novo. No modo incremental não há manifesto, então a foto fica registrada no portal e não sai no documento.

## Respostas

**signers** `array`

A lista gravada. Cada item tem `signerUuid`, `name`, `email`, `cpf` (só dígitos), `signatureType`, `livenessSource` (`HUB`, `EXTERNAL` ou `null`) e `livenessImagePath`.

## Erros

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

* **400**: Lista vazia, CPF inválido ou repetido, tipo de assinatura desconhecido, ou tipo por SMS sem `phoneNumber`.
* **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).
* **409**: A assinatura já foi enviada.

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

{
  "signers": [
    {
      "signerUuid": "6ba7b811-9dad-11d1-80b4-00c04fd430c8",
      "name": "Maria Souza",
      "email": "maria@exemplo.com.br",
      "cpf": "12345678909",
      "signatureType": "ICP_BRASIL",
      "livenessSource": null,
      "livenessImagePath": null
    },
    {
      "signerUuid": "6ba7b812-9dad-11d1-80b4-00c04fd430c8",
      "name": "João Lima",
      "email": "joao@exemplo.com.br",
      "cpf": "98765432100",
      "signatureType": "MFA_EMAIL",
      "livenessSource": null,
      "livenessImagePath": null
    }
  ]
}
```

## Exemplo

```bash theme={"theme":"catppuccin-latte"}
curl -X PUT "https://api.valid.com/signer/v1/incremental-signatures/550e8400-e29b-41d4-a716-446655440000/signers" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "signers": [
      { "name": "Maria Souza", "email": "maria@exemplo.com.br", "cpf": "12345678909", "qualification": "Tomador" },
      { "name": "João Lima", "email": "joao@exemplo.com.br", "cpf": "98765432100", "signatureType": "MFA_EMAIL" }
    ]
  }'
```

Veja os tipos de assinatura em [Assinatura incremental](https://docs-platform.services-valid.com.br/plataforma/assinatura-digital/assinatura-incremental.md#tipos-de-assinatura).


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