Skip to main content

Update Cost Change Policy Settings

PUT 
/api/cost-changes/settings

Replaces the routing policy for retroactive cost changes and returns the effective settings (same shape as Get Cost Change Policy Settings). trigger_policies must be present; every trigger you include needs all four rule fields, and triggers you omit fall back to their defaults. Unknown trigger keys are rejected.

Required scope: inventory:write

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

Authentication: Requires Bearer token (inventory scope) and permission to manage accounting settings.

Body fields:

  • trigger_policies (required, object keyed by trigger): landed_cost_bill, purchase_invoice_new, purchase_invoice_edited, po_line_edited, po_financials_edited, po_currency_changed, data_fix
  • trigger_policies.*.mode (required): auto, review or review_if_material
  • trigger_policies.*.auto_resolution (required): prospective, restate or restate_while_open
  • trigger_policies.*.materiality_amount (required, numeric, min 0)
  • trigger_policies.*.materiality_percent (required, numeric, 0-1000)
  • always_review_locked_impact (required, boolean): hold any change whose restate dates touch a locked period
  • always_review_closed_impact (required, boolean): hold any change touching a closed (not locked) period
  • always_review_synced_entries (required, boolean): hold any change that would reverse and replace entries already synced to the accounting provider

Request​

Responses​

OK

Response Headers
    Content-Type