Partially update purgatory settings
Partial update — only fields present in the body are written. Omitted
fields keep their stored values. Unknown field names are rejected with a
pointer to GET /purgatory/settings/schema.
Settings changes apply to new orders by default. Call
POST /purgatory/jobs/reprocess afterwards to apply the new rules to
existing non-posted orders.
Authorizations
Authenticate using a bearer token. To create a token, navigate to /settings/api-tokens and click Create API Token.
Body
Purgatory automation settings. All fields are optional in write payloads —
only keys present in the body are updated. See GET /purgatory/settings/schema
for field-level types, defaults, and descriptions.
Auto-post sales orders that have no line items.
Auto-post orders whose every line item is ignored.
Auto-post orders whose remaining non-ignored lines are all mapped to a product. Affects inventory — orders posted this way decrement stock.
Treat line items with an empty SKU as ignored.
Treat adjustment lines (coupons, negative qty, etc.) as ignored.
Do not deduct inventory for shipments older than the threshold.
Age in days at which a shipment is considered "old" for the skip rule.
x >= 0Skip inventory for shipments that look like duplicates of recently-posted orders.
Score (0–1) above which two orders are considered duplicates.
Required when skip_inventory_for_similar_orders is true.
0 <= x <= 1Orders with order_date before this ISO 8601 datetime are skipped by
purgatory automation. null disables the cutoff.
Per-app-integration-account order_date cutoffs. A matching account row
overrides the global skip_orders_older_than_date_cutoff for that account;
accounts without a row fall back to the global cutoff.
SKUs to always treat as ignored (exact match, case-insensitive).
Product names to always treat as ignored (exact match, case-insensitive).
Substrings or PHP regex patterns (wrap regex in slashes, e.g. /^test/)
matched against the line item SKU or name.
Push generated client invoices back to ShipStation as posted orders.
ShipStation store ID that receives pushed client invoices.
Push client invoices automatically rather than waiting for a manual trigger.
When the automatic push fires (e.g. on_invoice_create, on_invoice_send).