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

# Atualizar signatário

> Atualiza dados de um signatário (nome, email, CPF, telefone, etc.) antes de assinar.

Permite atualizar parcialmente os dados de um signatário, desde que ainda não tenha assinado. Todos os campos da requisição são opcionais — apenas os enviados serão atualizados.

## Parâmetros

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

<ParamField path="signerUuid" type="string" required>
  UUID do signatário a atualizar.
</ParamField>

<ParamField body="name" type="string">
  Novo nome completo.
</ParamField>

<ParamField body="email" type="string">
  Novo e-mail.
</ParamField>

<ParamField body="cpf" type="string">
  Novo CPF (11 dígitos, sem formatação).
</ParamField>

<ParamField body="phoneCountryCode" type="string">
  Novo código de país do telefone (ex: `"55"`).
</ParamField>

<ParamField body="phoneNumber" type="string">
  Novo número de telefone (ex: `"11987654321"`).
</ParamField>

<ParamField body="queueOrder" type="integer">
  Nova ordem na fila (apenas para `signingMode: sequential`).
</ParamField>

<ParamField body="livenessSessionId" type="string">
  Novo ID de uma sessão de liveness já realizada (para PAdES avançado).
</ParamField>

## Respostas

<ResponseField name="signerUuid" type="string">
  UUID do signatário.
</ResponseField>

<ResponseField name="name" type="string">
  Nome atualizado.
</ResponseField>

<ResponseField name="email" type="string">
  E-mail atualizado.
</ResponseField>

<ResponseField name="cpf" type="string">
  CPF atualizado.
</ResponseField>

<ResponseField name="phoneCountryCode" type="string">
  Código de país atualizado.
</ResponseField>

<ResponseField name="phoneNumber" type="string">
  Número de telefone atualizado.
</ResponseField>

<ResponseField name="queueOrder" type="integer">
  Ordem na fila (se aplicável).
</ResponseField>

<ResponseField name="livenessImagePath" type="string">
  Caminho da imagem de liveness (se fornecido).
</ResponseField>

<ResponseField name="updatedAt" type="string">
  Timestamp da atualização (ISO 8601).
</ResponseField>

## Erros

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

* **400**: CPF inválido, email malformado, ou signatário já assinou.
* **401**: API key inválido.
* **404**: Envelope ou signatário não encontrado.
* **409**: Signatário já assinou — não pode atualizar dados.

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

  {
    "signerUuid": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
    "name": "João Silva Atualizado",
    "email": "joao.novo@empresa.com",
    "cpf": "12345678901",
    "phoneCountryCode": "55",
    "phoneNumber": "11912345678",
    "queueOrder": 1,
    "updatedAt": "2025-07-27T11:00:00.000Z"
  }
  ```

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

  {
    "statusCode": 409,
    "message": "Cannot update signer after signature"
  }
  ```
</ResponseExample>

## Exemplo

```bash theme={"theme":"catppuccin-latte"}
curl -X PATCH "https://signer.vcc-service.com/v1/envelopes/550e8400-e29b-41d4-a716-446655440000/signers/6ba7b810-9dad-11d1-80b4-00c04fd430c8" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "João Silva Atualizado",
    "email": "joao.novo@empresa.com"
  }'
```

## Relacionado

* [`POST /v1/envelopes`](/plataforma/assinatura-digital/api/post-envelope) — criar envelope com signatários iniciais
* [`GET /v1/envelopes/:uuid`](/plataforma/assinatura-digital/api/get-envelope-by-id) — listar signatários do envelope