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

# Finalizar envelope manualmente

> Refaz a finalização automática de um envelope travado em 'Aguardando finalização'.

Força a finalização manual de um envelope que ficou travado em "Aguardando finalização" quando a finalização automática falhou. Use apenas em casos raros quando o último signatário assinou mas o envelope não transitou automaticamente para "Finalizado".

**Autenticação**: `x-api-key` no header. Também aceita `Authorization: Bearer`.

## Parâmetros

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

## Respostas

<ResponseField name="finalized" type="boolean">
  Confirmação de sucesso (`true`).
</ResponseField>

## Erros

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

* **404**: Envelope não encontrado.
* **409**: Envelope não está em "Aguardando finalização".
* **503**: Serviço de assinatura indisponível. Tente novamente mais tarde.

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

  {
    "finalized": true
  }
  ```

  ```json theme={"theme":"catppuccin-latte"}
  HTTP/1.1 503 Service Unavailable
  Content-Type: application/json

  {
    "statusCode": 503,
    "message": "Signature service unavailable"
  }
  ```
</ResponseExample>

## Exemplo

```bash theme={"theme":"catppuccin-latte"}
curl -X POST "https://api.valid.com/signer/v1/envelopes/550e8400-e29b-41d4-a716-446655440000/finalize" \
  -H "x-api-key: YOUR_API_KEY"
```

## Importante

* **Último recurso**: use apenas quando a finalização automática falhar.
* **Não é parte do fluxo normal**: envelopes normalmente finalizam sozinhos quando o último signatário assina.
* **Fora do assistente de criação**: esta operação não faz parte do wizard de passo a passo — é um endpoint de manutenção/recuperação.

## Relacionado

* [`GET /signer/v1/envelopes/:uuid`](/plataforma/assinatura-digital/api/get-envelope-by-id) — verificar estado do envelope


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