/bff/issue/status/create

Add an organisation-scoped refinement status inside one of the four canonical categories. System rows are seeded automatically and cannot be created here.

IssuepostBffIssueStatusCreate

Parameters

JSON body

Request body

application/json

statusCategoryIdnumberRequired

Category bucket (1=new, 2=progress, 3=waiting, 4=done).

Range: 1–4

labelstringRequired

Custom label (unique within category for the organisation).

Length: 1–48

sortOrdernumberOptional

UI ordering hint within the category (default 0).

Response schema

1 status code documented

200Success

successbooleanRequired

idnumberRequired

ID of the newly created status.

Response example

application/json

{
  "success": false,
  "id": 0
}

Request example

POST /bff/issue/status/create

post

curl -X POST "https://api.bizkithub.com/bff/issue/status/create" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "statusCategoryId": 0,
  "label": "example_label",
  "sortOrder": 0
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key