Skip to content

Update a price adjustment

PATCH
/v1/pricing/adjustments/{id}

Partially update an existing price adjustment. Send only the fields you want to change (e.g. status, targets, effect, conditions). Server-controlled fields (companyId, id, created, changed) are stripped from the body. The adjustment must belong to the authenticated company. Changing a coupon conditions.code to one already used by another active adjustment returns 409.

id
required
string
Example
padj_123abc

The price adjustment ID.

A partial PriceAdjustment — any subset of mutable fields.

Placeholder schema for PriceAdjustment. Add it to the schemaMap in scripts/create-content/api-docs.mjs for a richer definition.

object
Example
{
"status": "inactive"
}

The updated price adjustment record

object
status
string
Example
ok
data

Placeholder schema for PriceAdjustment. Add it to the schemaMap in scripts/create-content/api-docs.mjs for a richer definition.

object

Validation failed — the patch did not satisfy the schema

object
status
string
Example
error
message
string
Example
An error occurred
error
string

Unauthorized — a valid bearer token is required

object
status
string
Example
error
message
string
Example
An error occurred
error
string

Forbidden — the adjustment belongs to a different company

object
status
string
Example
error
message
string
Example
An error occurred
error
string

Not found — no such adjustment

object
status
string
Example
error
message
string
Example
An error occurred
error
string

Conflict — the new coupon code is already taken

object
status
string
Example
error
message
string
Example
An error occurred
error
string

Internal server error

object
status
string
Example
error
message
string
Example
An error occurred
error
string