---
title: "POST /public_api/subscriptions/{id}/cancel/"
method: POST
path: "/public_api/subscriptions/{id}/cancel/"
tags: ["subscriptions"]
---

# POST /public_api/subscriptions/{id}/cancel/

`POST /public_api/subscriptions/{id}/cancel/`

Cancela uma assinatura imediatamente.

## Path parameters

- `id` string, uuid, required

## Response `200`

Assinatura cancelada com sucesso.

- SubscriptionActionResponse
  - `detail` string, required — Mensagem de retorno da operação
  - `status` 'active' | 'inactive' | 'canceled' | 'expired' | 'paused' | 'trial' — * `active` - Ativa * `inactive` - Inativa * `canceled` - Cancelada * `expired` - Expirada * `paused` - Pausada * `trial` - Em período de teste

## Other responses

- `400` — Assinatura já cancelada ou estado atual não permite cancelamento.
- `401` — Request não autenticado devido à ausência ou invalidez do token.
- `404` — Assinatura não encontrada.

---

[API](https://skmtc.net/cakto/apis/cakto-api.md) · [All operations](https://skmtc.net/cakto/apis/cakto-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cakto/cakto-api/versions/cba77b0560b5/schema)