---
title: "Gerar novo link de assinatura"
method: POST
path: "/v1/signing-sessions/{sessionId}/link"
tags: ["SigningSessions"]
---

# Gerar novo link de assinatura

`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

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

## Path parameters

- `sessionId` string, required

## Response `200`

Novo link gerado com sucesso.

- MintSigningLinkResponse: Nova URL de assinatura para uma sessão existente.
  - `sessionId` string, required
  - `transactionId` string, required
  - `url` string, uri, required: URL de assinatura de uso único.
  - `expiresAt` string, date-time, required: Prazo da sessão original — não é estendido por esta chamada.
  - `expiresIn` integer, required: Segundos restantes até `expiresAt`.

## Other responses

- `401`: Autenticação ausente ou inválida.
- `404`: Recurso não encontrado.
- `409`: Conflito de estado — a operação não pode ser realizada no estado atual do recurso.
- `500`: Erro interno do servidor.

---

[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)