Skip to main content

Delete Lifecycle State

DELETE 

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

Delete a custom lifecycle state. System states (active, phasing_out, discontinued) cannot be deleted. When products are still in the state you must name reassign_to; every product is then moved to that state and gets a history entry noting the deletion.

Required scope: products:write

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

Query parameters:

  • reassign_to (string, max 40): key of a different, existing state to move the state's products to. Required only while the state has products.

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

Request​

Responses​

OK

Response Headers
    Content-Type