API · Assinaturas

Pausar ou retomar assinatura

PATCH /api/crypto/v1/subscriptions/{id}/paused — controle a recorrência.

PATCH /api/crypto/v1/subscriptions/{id}/paused

Autentique com X-Manage-Token, usando o token retornado na criação. O backend também aceita manageToken na query, mas prefira o cabeçalho para evitar exposição em histórico e logs.

Envie o booleano paused: true pausa, false retoma. A pausa interrompe a criação de novos ciclos; um ciclo já aberto continua disponível.

curl -X PATCH 'https://api.caedral.com/api/crypto/v1/subscriptions/ID_DA_ASSINATURA/paused' \
  -H 'Content-Type: application/json' -H 'X-Manage-Token: SEU_MANAGE_TOKEN' \
  -d '{"paused":true}'

200 retorna paused e pode incluir unchanged: true se o estado já correspondia ao solicitado. 400: paused não é booleano; 404: assinatura não encontrada, token inválido ou tentativa de retomar uma assinatura cancelada; 500: falha interna.

Exemplo de resposta 200

Os valores são ilustrativos e variam conforme o ambiente e a ordem.

{
  "paused": true
}