---
title: "Cancelar sessão de assinatura"
method: POST
path: "/v1/signing-sessions/{sessionId}/cancel"
tags: ["SigningSessions"]
---

# Cancelar sessão de assinatura

`POST /v1/signing-sessions/{sessionId}/cancel`

## Request

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

Cancela uma sessão de assinatura ativa. Apenas sessões com status ACTIVE podem
ser canceladas. O cancelamento cascateia para a transação subjacente.

Requer scope `transactions:write`.

## Path parameters

- `sessionId` string, required

## Response `200`

Sessão cancelada com sucesso.

- CancelSigningSessionResponse: Resposta do cancelamento de sessão.
  - `sessionId` string, required
  - `transactionId` string, required
  - `status` 'ACTIVE' | 'COMPLETED' | 'CANCELLED' | 'EXPIRED' | 'FAILED', required: Status da sessão de assinatura.
  - `cancelledAt` string, date-time, required

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