Submit thumbs up/down feedback on an AI assistant answer.
POST/v1/projects/{projectId}/chat/feedback/{messageId}Try it
Record visitor feedback on a specific AI assistant answer. Feedback feeds the AI insights dashboard and helps identify low-quality answers and documentation gaps.
Path Parameters
NameDescription
projectId:stringpathRequired
The project ID.
messageId:stringpathRequired
The ID of the assistant message being rated — the X-Message-Id response header of the chat endpoint that produced the answer. The answer is saved when its stream finishes, so send feedback after the stream completes; an ID used before then gets 404.
The message must belong to projectId. A message ID from a different project
is rejected with 404 not_found — it is not silently accepted.
Request Body
NameDescription
feedback:stringbodyRequired
Either thumbs_up or thumbs_down.
Note
On your doc site this endpoint is also served same-origin at POST /_chat/feedback/{messageId}. The project comes from the site's hostname; a messageId that isn't a UUID is rejected with 400 before it reaches the API.
Errors
Status
Code
When
400
validation_error
feedback is missing or is not thumbs_up/thumbs_down
404
not_found
No such message, or the message belongs to another project