Skip to content

Delete every step no case carries

DELETE
/v1/settings/steps
curl --request DELETE \
--url 'https://beta-api.plune.ai/v1/settings/steps?unused=true' \
--header 'Authorization: Bearer <token>'

«Delete unused»: the rows with count: 0 go — steps made by hand and never used, and steps orphaned when a case was edited. ?unused=true is the only form; without it the request is refused (400): a bulk delete of USED steps would be a rewrite of cases nobody asked for.

unused
required
string
Allowed values: true

How many rows went

Media type application/json
object
deleted
required
integer
Example
{
"deleted": 2
}

unused=true is missing

Media type application/json
object
error
required
string
Example
{
"error": "pass ?unused=true — only unused steps are deleted in bulk"
}

No / invalid token or session

Rate-limited: either the per-route throttle or a tenant quota. Retry-After carries the seconds until the window rolls over.

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}
Retry-After
integer

Seconds until the window rolls over