---
title: "Reenviar convite de assinatura"
method: POST
path: "/v1/signing-sessions/{sessionId}/resend-invite"
tags: ["SigningSessions"]
---

# Reenviar convite de assinatura

`POST /v1/signing-sessions/{sessionId}/resend-invite`

## Request

- Base URL: `https://api.signdocs.com.br`
- URL: `https://api.signdocs.com.br/v1/signing-sessions/{sessionId}/resend-invite`
- Auth: HTTP bearer

Reenvia o convite de uma sessão `ACTIVE` — por exemplo, quando o original
caiu no spam ou se perdeu. Gera um link novo (novo `clientSecret`); o link
anterior continua válido até a sessão expirar.

Sem corpo, reenvia pelos canais com que o signatário foi criado
(`deliverVia`); sessões sem canais gravados reenviam por e-mail. Informe
`deliverVia` no corpo para escolher outros canais nesta chamada.

Limitado a um reenvio a cada 60 segundos por sessão: dentro desse intervalo
a chamada retorna `409` com o tempo restante. Também retorna `409` quando a
sessão não está `ACTIVE`, ou quando o e-mail é pedido e a sessão não tem
e-mail do signatário.

Reenvios por WhatsApp e Telegram consomem a cota de mensagens do tenant:
esgotada, a chamada retorna **429** antes de gerar link ou enviar qualquer
mensagem.

Requer scope `transactions:write`.

## Path parameters

- `sessionId` string, required

## Request body

- ResendSigningInviteRequest: Corpo opcional de `resend-invite`.
  - `deliverVia` string[]: Canais para este reenvio. Omitido: os canais com que o signatário foi criado, ou e-mail para sessões sem canais gravados. Mesmas regras de `deliverVia` na criação da sessão, inclusive a cota de mensagens (429).

## Response `200`

Convite reenviado.

- ResendSigningInviteResponse: Resultado do reenvio de convite.
  - `sessionId` string, required
  - `transactionId` string, required
  - `to` string, email: E-mail para o qual o convite foi reenviado. Presente só quando o reenvio incluiu e-mail.
  - `whatsappInviteSent` boolean: `true` quando a Meta aceitou a mensagem, o que não confirma a entrega. Omitido em qualquer outro caso.
  - `telegramInviteSent` boolean: Resultado do envio pelo bot do Telegram. Presente sempre que o reenvio incluiu `telegram`; `false` quando o convite não chegou.
  - `resentAt` string, date-time, required: Data/hora do reenvio (ISO 8601 UTC).

## Other responses

- `400`: Requisição inválida — parâmetros ausentes ou malformados.
- `401`: Autenticação ausente ou inválida.
- `403`: Permissões insuficientes para a operação solicitada. Inclui `purpose: "ACTION_AUTHENTICATION"` sem `featureFlags.trustSessionsEnabled`. A verificação é pelo `purpose`, não pela rota: vale em `/v1/transactions`, `/v1/signing-sessions` e `/v1/envelopes/{envelopeId}/sessions`, além de `/v1/trust-sessions`. O remédio é habilitar a flag para o tenant e provisionar a cota `monthlyTrustSessions`.
- `404`: Recurso não encontrado.
- `409`: Conflito de estado — a operação não pode ser realizada no estado atual do recurso.
- `422`: Entidade não processável — a requisição é sintaticamente válida mas semanticamente incorreta. Inclui o perfil de política não autorizado para o tenant. As rotas de criação (`/v1/transactions`, `/v1/signing-sessions` e `/v1/envelopes/{envelopeId}/sessions`) verificam a mesma regra, antes de cota, convite e gravação — a recusa não consome documento. As flags envolvidas são `featureFlags.customPolicyEnabled` (perfil `CUSTOM`), `serpro.enabled` (perfis SERPRO), `featureFlags.documentExtractionEnabled` (fallback por documento; `BIOMETRIC_SERPRO_AUTO_FALLBACK` exige as duas últimas) e `featureFlags.biometricRequired`. O remédio é habilitar a flag para o tenant. `signer.cpf` e `signer.birthDate`, exigidos pelos perfis SERPRO, são validados como **400** e não aqui: requisição malformada, corrigível na mesma chamada.
- `429`: Limite de requisições excedido.
- `500`: Erro interno do servidor.
- `503`: Serviço temporariamente indisponível.

---

[API](https://skmtc.dev/signdocs/apis/signdocs-brasil-external-api.md) · [All operations](https://skmtc.dev/signdocs/apis/signdocs-brasil-external-api/llms.txt) · [OpenAPI document](https://skmtc.dev/signdocs/apis/signdocs-brasil-external-api/revisions/2d3805aed161?raw)