Skip to main content
PUT
Partially update purgatory settings

Authorizations

Authorization
string
header
required

Authenticate using a bearer token. To create a token, navigate to /settings/api-tokens and click Create API Token.

Body

application/json

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.

post_empty_orders
boolean

Auto-post sales orders that have no line items.

post_orders_ignored_all_items
boolean

Auto-post orders whose every line item is ignored.

post_clean_orders
boolean

Auto-post orders whose remaining non-ignored lines are all mapped to a product. Affects inventory — orders posted this way decrement stock.

ignore_empty_sku
boolean

Treat line items with an empty SKU as ignored.

ignore_adjustment_line_item
boolean

Treat adjustment lines (coupons, negative qty, etc.) as ignored.

skip_inventory_for_old_shipments
boolean

Do not deduct inventory for shipments older than the threshold.

skip_inventory_for_old_shipments_days
integer

Age in days at which a shipment is considered "old" for the skip rule.

Required range: x >= 0
skip_inventory_for_similar_orders
boolean

Skip inventory for shipments that look like duplicates of recently-posted orders.

similarity_threshold
number<float> | null

Score (0–1) above which two orders are considered duplicates. Required when skip_inventory_for_similar_orders is true.

Required range: 0 <= x <= 1
skip_orders_older_than_date_cutoff
string<date-time> | null

Orders with order_date before this ISO 8601 datetime are skipped by purgatory automation. null disables the cutoff.

skip_orders_older_than_date_cutoff_by_account
object[]

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.

ignored_skus
string[]

SKUs to always treat as ignored (exact match, case-insensitive).

ignored_product_names
string[]

Product names to always treat as ignored (exact match, case-insensitive).

ignored_patterns
string[]

Substrings or PHP regex patterns (wrap regex in slashes, e.g. /^test/) matched against the line item SKU or name.

push_client_invoice_to_shipstation
boolean

Push generated client invoices back to ShipStation as posted orders.

push_client_invoice_shipstation_store_id
integer | null

ShipStation store ID that receives pushed client invoices.

push_client_invoice_to_shipstation_automatically
boolean

Push client invoices automatically rather than waiting for a manual trigger.

push_client_invoice_to_shipstation_timing
string | null

When the automatic push fires (e.g. on_invoice_create, on_invoice_send).

Response

Merged settings after update

data
object

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.

schema_url
string
message
string