Criar ou atualizar assinatura

PUT 
/v1/subscriptions

Recebe o mesmo corpo do POST, acrescido de id e public_id, e deduplica por id, public_id, external_id e as chaves naturais do recurso, nesta ordem, parando na primeira que encontrar um registro. Se encontrar, atualiza e responde 200; se não, cria e responde 201. Os campos obrigatórios do POST só são exigidos quando nenhum registro é encontrado, e a atualização é parcial: campos ausentes mantêm o valor atual.

Request

Responses

200

Registro atualizado.

201

Registro criado.

400

Corpo da requisição falhou na validação.

401

Token bearer ausente ou inválido.

403

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"].

404

Recurso não encontrado na organização atual.

422

Corpo da requisição falhou na validação.

429

Limite de requisições excedido.

500

Erro inesperado no servidor.