Skip to main content

Reset Lifecycle State Policies

POST 

/api/v2/product-lifecycle/states/:state/policies/reset

Put a system state's policies back to their defaults (custom states have no defaults and return 422). When products are in the state, a background job re-applies the policy and its id is returned as tracked_job_id; null otherwise. No body.

Required scope: products:write

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

State fields: key (stable identifier used in URLs and on products), label, description, color, is_system (true for active, phasing_out and discontinued, which cannot be deleted), sort_order, product_count (products currently in the state), auto_return (null, or {after_days, to_state}: products move back automatically after that many days), and policies — one entry per business process with process, label, help, value (current), value_label, default_value (the system default for this state), and allowed_values [{value, label}].

Requires a Bearer token with the products read/write scope and the settings.update permission.

Request​

Responses​

OK

Response Headers
    Content-Type