Knowledge bases

Sort order

Applies the manual category order of the articles in one category (category_id 0 = uncategorized). Send every article of the category in the wanted order; ranks are computed server-side with minimal writes.

PUT /api/{tenant:minlength(2)}/v{version:apiVersion}/knowledge_bases/sort_order

Authorisation: Minimum role: USER

Request arguments

Name	Type	Source
input	DTO_knowledge_base_sort_order	Body

Request body example

Response

Status: 200 (OK)
Type: DTO_acknowledgement

Wrapper: DTO_response_wrap

Other statuses: 400 (BadRequest), 401 (Unauthorized), 403 (Forbidden), 429 (TooManyRequests)

Response body example

DTO_knowledge_base_sort_order

Name	Type	ReadOnly	Description
category_id	Int32		Category id
ordered_ids	Int32[]		Ordered ids

DTO_acknowledgement

Name	Type	ReadOnly	Description
message	String		Message

Generated Aug 22, 2026 09:36