Skip to content
LogoLogo

Archive a workflow Status

Archive a workflow Status

DELETE/api/v1/statuses/{status_id}

Archives a Status without repointing Tasks. It returns 409 status_in_use with the live Task count when live Tasks still reference it, and 409 required_status when it is the last active todo, in_progress, or done Status in its own scope.

Path Parameters

status_idRequired
string <uuid>
Example0198ac5e-f9b7-7000-8000-000000000001

Header Parameters

X-CSRF-TokenRequired
string·min 43·max 43

Session-bound CSRF token. It must exactly match the __Host-assign_csrf cookie sent with the request.

If-MatchRequired
string

Entity tag containing the resource version last observed by the client.

Idempotency-KeyRequired
string·min 16·max 200

Opaque client-generated key for safely retrying this operation.

Responses

204The Status is archived.