Update a promotion

PATCH 
/v1/promotions/:id

Partially updates an existing promotion (coupon). Only the fields you send are changed; omitted fields keep their current value. A field can be set but not cleared — upstream drops explicit nulls before applying the patch, so sending one is rejected with a 422 instead of being silently ignored.

Required scope: promotions:write

Request

Responses

200

The updated promotion.

401

Unauthenticated — the request is missing a credential, or the Bearer token / API key is invalid, expired, or revoked.

403

Insufficient scope — the credential is authenticated but lacks a scope the endpoint requires.

404

Not found — no resource matches the id in the path (or it belongs to a different company).

422

Validation failed — the request body failed schema validation. errors[] lists every offending field.