Skip to main content

Get Cost Change Policy Settings

GET 
/api/cost-changes/settings

Returns the routing policy for retroactive cost changes: per trigger type, whether a change applies immediately or is held in the inbox for review, and which resolution an automatic application uses. These rules decide routing only - every change stays an individually dated revaluation and any held set can still be resolved either way by a person.

Required scope: inventory:read

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

trigger_policies is keyed by trigger (landed_cost_bill, purchase_invoice_new, purchase_invoice_edited, po_line_edited, po_financials_edited, po_currency_changed, data_fix). Each rule has:

  • mode: auto (apply without review), review (always hold), review_if_material (hold when the delta reaches materiality_amount or materiality_percent)
  • auto_resolution: prospective, restate, or restate_while_open (restate while the original months are still open, otherwise go forward)
  • materiality_amount / materiality_percent: thresholds for review_if_material
  • label: display name of the trigger

Triggers without an explicit rule report the default (auto, prospective, 100 / 5%), except data_fix which defaults to review. The three always_review_* guardrails escalate any set that touches a locked period, a closed period, or entries already synced to the accounting provider, regardless of the trigger's rule.

Authentication: Requires Bearer token (inventory scope).

Request​

Responses​

OK

Response Headers
    Content-Type