Knowledge bases

Rate

Records a thumbs up or thumbs down on an article, rate must be UP or DOWN and the calling User needs group access to the article. A User's vote is remembered for 12 hours: repeating the same value inside that window changes nothing, while switching moves the count from one side to the other instead of adding a second vote.

POST /api/{tenant:minlength(2)}/v{version:apiVersion}/knowledge_bases/rate/{id}

Authorisation: Minimum role: USER

Request arguments

Name	Type	Source
id	Int32
input	DTO_knowledge_base_rate_input	Body

Request body example

Response

Status: 200 (OK)
Type: DTO_acknowledgement

Wrapper: DTO_response_wrap

Other statuses: 400 (BadRequest), 403 (Forbidden)

Response body example

DTO_knowledge_base_rate_input

Name	Type	ReadOnly	Description
rate	ENUM knowledge_base_rate		Rate

DTO_acknowledgement

Name	Type	ReadOnly	Description
message	String		Message

ENUM knowledge_base_rate

Value	Name	Description
0	UNKNOWN	UNKNOWN
1	NOT_SET	NOT SET
2	UP	UP
3	DOWN	DOWN

Generated Aug 4, 2026 18:37