Knowledge Bank / REFERENCE

Create a knowledge category

Create or partially update a category. Parent categories must belong to this workspace; cycles are rejected. Use active:false to deactivate.

POST/api/v1/kb/categories

Permissions kb:write

Parameters

Name	Description
`X-Luma-Workspace-Host`header · required	Your workspace host, e.g. acme.lumi-cx.com. Required on api.lumi-cx.com. This header never grants access: the Bearer key must belong to the selected workspace.

Request body

Field	Type & description
`parentId`	string \| null
`nameEn`	string
`nameAr`	string
`slug`	string
`icon`	string
`sortOrder`	integer
`active`	boolean

Responses

201 Successful operation

{
  "ok": true,
  "category": {
    "id": "00000000-0000-4000-8000-000000000001",
    "parentId": "00000000-0000-4000-8000-000000000001",
    "nameEn": "example",
    "nameAr": "example",
    "slug": "example",
    "icon": "example",
    "sortOrder": 1,
    "active": false,
    "articleCount": 1,
    "children": []
  }
}

400 Invalid request

{
  "ok": false,
  "error": "invalid_body",
  "message": "example"
}

401 Missing, invalid, expired, revoked or wrong-workspace key

{
  "ok": false,
  "error": "invalid_body",
  "message": "example"
}

403 Required key permission missing, module unavailable, or workspace suspended

{
  "ok": false,
  "error": "invalid_body",
  "message": "example"
}

404 Record, workspace or route not found

{
  "ok": false,
  "error": "invalid_body",
  "message": "example"
}

409 Version changed or the resource is locked

{
  "ok": false,
  "error": "invalid_body",
  "message": "example"
}

429 Rate limit exceeded; respect Retry-After

{
  "ok": false,
  "error": "invalid_body",
  "message": "example"
}

502 Upstream or unexpected server error

{
  "ok": false,
  "error": "invalid_body",
  "message": "example"
}