Atualizar uma promoção
PATCH/v1/promotions/:id
Atualiza parcialmente uma promoção (cupom) existente. Somente os campos enviados são alterados; campos omitidos mantêm seu valor atual. Um campo pode ser definido, mas não limpo — o upstream descarta nulls explícitos antes de aplicar o patch, então enviar um é rejeitado com 422 em vez de ser silenciosamente ignorado.
Escopo necessário: promotions:write
Request
Responses
- 200
- 401
- 403
- 404
- 422
A promoção atualizada.
Não autenticado — a requisição não possui uma credencial, ou o token Bearer / API key é inválido, expirou ou foi revogado.
Escopo insuficiente — a credencial está autenticada, mas não possui um escopo exigido pelo endpoint.
Não encontrado — nenhum recurso corresponde ao id no caminho (ou ele pertence a outra empresa).
Falha de validação — o corpo da requisição falhou na validação do schema. errors[] lista todos os campos com problema.