Trocar o aniversário (dia de início do ciclo) da assinatura
POST/v1/subscriptions/:id/change-anniversary
Move o dia do mês em que os ciclos começam. O ciclo em andamento mantém o início e é estendido até a véspera do novo dia; os dias acrescentados são cobrados pro rata (valor do ciclo × dias ÷ dias do ciclo) numa fatura subscription_update. A troca sempre avança a data, nunca a recua. Use dry_run para calcular sem aplicar.
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
- 500
Resultado da troca (ou da simulação, com dry_run).
Token bearer ausente ou inválido.
Token válido, porém sem permissão para esta operação. Com code insufficient_scope, details.required traz o único conjunto mínimo de escopos que, somados a details.granted, deixaria a requisição passar: o escopo do recurso (billing/{recurso}, ou billing/all fora do catálogo) e depois o verbo puro — por exemplo ["billing/customers", "delete"].
Recurso não encontrado na organização atual.
Corpo da requisição falhou na validação.
Limite de requisições excedido.
Erro inesperado no servidor.