Skip to main content

Dismiss Lifecycle Suggestion

POST 

/api/v2/product-lifecycle/suggestions/:suggestion/dismiss

Dismisses an open or snoozed suggestion with a reason. The same rule will not suggest a change for this product again for 180 days (suppressed_until).

Required scope: products:write

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

Body:

  • reason (required, string, max 255): why the suggestion does not apply

Response: the updated suggestion (status dismissed, dismiss_reason, suppressed_until, resolved_by_user_id, resolved_at).

Suggestion fields: id, product_id, product (id, sku, name, lifecycle_state, lifecycle_state_label, lifecycle_state_color), rule (all_suppliers_discontinued, dormant, cz_classification, channel_inactive, season_ended, successor_launched), rule_label, suggested_state (state key, e.g. discontinued or phasing_out), suggested_state_label, suggested_state_color, suggested_reason (brand_decision, supplier_discontinued, seasonal_end, low_performance, replaced, quality_issue, other), suggested_reason_label, evidence (the signal behind the suggestion: a human-readable summary, rule-specific numbers such as days, on_hand, stock_value, last_sold_at, supplier_count or successor_sku, links [{label, url}] and evaluated_at), status (open, accepted, dismissed, snoozed), dismiss_reason, snoozed_until (date), suppressed_until (date), resolved_by_user_id, resolved_at, created_at, updated_at.

Returns 422 when the reason is missing or the suggestion was already accepted or dismissed.

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

Request​

Responses​

OK

Response Headers
    Content-Type