Create a Workspace-wide workflow Status
Create a Workspace-wide workflow Status
/api/v1/workspaces/{workspace_id}/statusesAppends a Status that applies to every Project in the Workspace.
This requires workspace:manage: unlike a Project-local Status, the
new catalog entry changes how all Workspace work is categorized.
Path Parameters
Header Parameters
Request Body
Responses
stringQuoted decimal optimistic-concurrency version.
objectMaterialized lifecycle policy of the entity's current status. Compare
stage_revision and definition_revision for staleness; behaviors
is the complete set for the entity kind, so clients never infer policy
from names or categories. Absent when the selection has no lifecycle
status. Resolved for a whole page with one batch lookup. Project list
rows carry identities and revisions only: stage_name and behaviors
are omitted there and returned by Project detail and the lifecycle
definition list.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string <uuid>Null for a Workspace-wide Status applicable to every Project.
stringCanonical lifecycle meaning. Custom labels remain presentation; completed and cancelled are terminal.
backlogunstartedstartedcompletedcancelledstringOptional shared Tailwind family or pinned shade, retaining legacy six-digit hex colors. A bare family uses step 500 for Status markers; null inherits the lifecycle default.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.