Skip to main content
DELETE
/
public_api
/
subscriptions
/
{id}
/
cURL
curl --request DELETE \
  --url https://api.cakto.com.br/public_api/subscriptions/{id}/ \
  --header 'Authorization: Bearer <token>'
{
  "detail": "As credenciais de autenticação não foram fornecidas."
}

​
Escopo

    write subscriptions

​
O que faz

Remove permanentemente o registro da assinatura do sistema. Diferente do cancelamento, a exclusão apaga o histórico da assinatura e não pode ser desfeita. Utilize esta ação apenas quando o registro foi criado erroneamente ou quando a exclusão é exigida por questões de compliance.

​
Casos de uso

  • Remover assinaturas criadas em duplicidade ou por erro de integração
  • Atender solicitações de exclusão de dados pessoais (LGPD/GDPR)
  • Limpar registros de teste em ambientes de homologação
  • Corrigir assinaturas vinculadas a pedidos incorretos

​
Parâmetro

id (path) — Identificador único da assinatura.

​
Erros

StatusDescrição
404Assinatura não encontrada.
Esta operação é irreversível. O registro da assinatura será permanentemente removido. Para interromper cobranças mantendo o histórico, utilize o endpoint de cancelamento.

Authorizations

​
Authorization
string
header
required

Token de autenticação do tipo Bearer {access_token}, onde {access_token} é o token obtido no fluxo de autenticação.

Path Parameters

​
id
string<uuid>
required

Id da assinatura.

Response

Assinatura removida.