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

# Revisar configurações do envelope

> Atualiza título, vencimento ou frequência de lembretes de um envelope em rascunho.

Atualiza as configurações gerais de um envelope em rascunho. Use esta chamada para permitir que o operador corrija dados após revisar na tela.

**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 rascunho.
</ParamField>

<ParamField body="title" type="string" optional>
  Novo título (máximo 255 caracteres).
</ParamField>

<ParamField body="dueDate" type="string" optional>
  Nova data limite (ISO 8601, deve ser futura).
</ParamField>

<ParamField body="reminderEveryHours" type="integer" optional>
  Nova frequência de lembretes (1–720 horas).
</ParamField>

## Respostas

Retorna o objeto `EnvelopeDraftResponse` atualizado com os mesmos campos de [`POST .../drafts`](/plataforma/assinatura-digital/api/post-envelope-draft).

## Erros

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

* **400**: Dados inválidos (vencimento passado, frequência fora do intervalo, etc.).
* **404**: Envelope não encontrado ou não pertence ao seu projeto.
* **409**: Envelope não está em rascunho (já foi enviado ou cancelado).

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

  {
    "envelopeUuid": "550e8400-e29b-41d4-a716-446655440000",
    "title": "Contrato de Serviços 2025 — REVISADO",
    "stateId": 1,
    "state": "Enviar arquivos",
    "dueDate": "2026-01-15T23:59:59Z",
    "reminderEveryHours": 48,
    "signingMode": "parallel"
  }
  ```

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

  {
    "statusCode": 409,
    "message": "Envelope is not a draft"
  }
  ```
</ResponseExample>

## Exemplo

```bash theme={"theme":"catppuccin-latte"}
curl -X PATCH "https://api.valid.com/signer/v1/envelopes/550e8400-e29b-41d4-a716-446655440000/settings" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Contrato de Serviços 2025 — REVISADO",
    "dueDate": "2026-01-15T23:59:59Z",
    "reminderEveryHours": 48
  }'
```

## Importante

* **Só em rascunho**: esta operação funciona apenas enquanto o envelope estiver no estado "Enviar arquivos". Após avanço, não é mais possível editar configurações.
* **Parcial**: você pode atualizar só alguns campos, deixando os outros intactos.

## Relacionado

* [`POST .../drafts`](/plataforma/assinatura-digital/api/post-envelope-draft) — criar envelope rascunho
* [`POST .../:uuid/back`](/plataforma/assinatura-digital/api/post-envelope-back) — voltar a passos anteriores
* [`POST .../:uuid/advance`](/plataforma/assinatura-digital/api/post-envelope-advance) — avançar no fluxo


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