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

# Enviar envelope aos signatários

> Finaliza o assistente, criando sessões e disparando convites por e-mail.

Finaliza o assistente de criação de envelope. Esta chamada:

1. Cria uma sessão única para cada signatário (com `sessionToken`).
2. Registra o histórico de criação.
3. Muda o envelope para "Aguardando assinatura".
4. Dispara e-mails de convite aos signatários.

**Importante**: o estado muda **antes** de disparar e-mails, para evitar duplicar sessões em caso de falha parcial.

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

## Parâmetros

<ParamField path="uuid" type="string" required>
  UUID do envelope (na etapa "Conferência").
</ParamField>

## Respostas

<ResponseField name="envelope" type="object">
  Dados do envelope (mesmo formato de [`POST .../drafts`](/plataforma/assinatura-digital/api/post-envelope-draft)).
</ResponseField>

<ResponseField name="signers" type="array">
  Lista de signatários com sessões criadas:

  * `signerUuid` — UUID do signatário.
  * `sessionToken` — token único para a sessão de assinatura deste signatário.
  * `signUrl` — URL completa (ex.: `https://seu-app.com/signer/{sessionToken}`) para compartilhar com o signatário.
</ResponseField>

## Erros

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

* **404**: Envelope não encontrado.
* **409**: Envelope não está na etapa "Conferência", ou faltam documentos/signatários.

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

  {
    "envelope": {
      "envelopeUuid": "550e8400-e29b-41d4-a716-446655440000",
      "stateId": 6,
      "state": "Aguardando assinatura",
      "title": "Contrato de Serviços 2025"
    },
    "signers": [
      {
        "signerUuid": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
        "sessionToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
        "signUrl": "https://seu-app.com/signer/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
      },
      {
        "signerUuid": "6ba7b811-9dad-11d1-80b4-00c04fd430c8",
        "sessionToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
        "signUrl": "https://seu-app.com/signer/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
      }
    ]
  }
  ```

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

  {
    "statusCode": 409,
    "message": "Envelope must be in review step to send"
  }
  ```
</ResponseExample>

## Exemplo

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

## Importante

* **Irreversível**: após send, o envelope não pode voltar a "Rascunho".
* **Sessões criadas**: cada signatário recebe um `sessionToken` único para acessar sua sessão de assinatura.
* **E-mails**: convites são disparados após a mudança de estado. Se alguns e-mails falharem, o envelope já saiu de rascunho (estado já mudou) — o operador pode usar [`POST .../:uuid/signers/:signerUuid/resend-invitation`](/plataforma/assinatura-digital/api/post-envelope-signer-resend-invitation) para reenviar.
* **URLs dos signatários**: distribua o `signUrl` de cada signatário para que acessem suas sessões de assinatura.

## Próximas etapas

1. Compartilhe o `signUrl` de cada signatário (via e-mail, SMS, ou QR Code).
2. Cada signatário acessa sua sessão: [`GET /signer/v1/sign/:sessionToken`](/plataforma/assinatura-digital/api/get-sign-session).
3. Preenche campos (se houver) e assina: [`POST /signer/v1/sign/:sessionToken/sign`](/plataforma/assinatura-digital/api/post-sign).
4. Quando o último signatário assina, o envelope muda para "Finalizado" e um webhook é disparado (se configurado).

## Relacionado

* [`POST .../:uuid/advance`](/plataforma/assinatura-digital/api/post-envelope-advance) — chegar à etapa de conferência antes disto
* [`POST .../:uuid/signers/:signerUuid/resend-invitation`](/plataforma/assinatura-digital/api/post-envelope-signer-resend-invitation) — reenviar convite
* [`POST /signer/v1/sign/:sessionToken/sign`](/plataforma/assinatura-digital/api/post-sign) — signatário assina


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