SigningSessions

Gerar novo link de assinatura

Gera uma nova URL de assinatura para uma sessão existente.

O link de assinatura é de uso único: depois que o signatário conclui — ou se o token embutido é consumido de outra forma — reabrir a mesma URL retorna 401 Embed token has been consumed. Use este endpoint para emitir um link novo sem criar outra transação e sem consumir cota.

Vale para sessões avulsas e para sessões de envelope, indistintamente.

Somente sessões ACTIVE. Uma sessão já concluída ou cancelada responde 409 Session cannot be linked in status: <status> — um link para uma sessão encerrada não autenticaria nada. Para dar acesso ao documento assinado use POST /v1/envelopes/{envelopeId}/combined-stamp (envelope) ou GET /v1/transactions/{transactionId}/download (transação avulsa).

A URL herda o prazo da sessão original: expiresAt não é estendido.

Requer scope transactions:write.

post/v1/signing-sessions/{sessionId}/link

Request

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

Path parameters

sessionIdstring required

Identificador único da sessão de assinatura.

Response

Novo link gerado com sucesso.

sessionIdstring required
transactionIdstring required
urlstring uri required

URL de assinatura de uso único.

expiresAtstring date-time required

Prazo da sessão original — não é estendido por esta chamada.

expiresIninteger required

Segundos restantes até expiresAt.

Changes

No recorded changes to this operation across all 1 revision of this API.