/Docs
Search docs or ask a question⌘K
DocsAgent
Changelog
API Reference Submit Chat Feedback

Submit Chat Feedback

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

StatusCodeWhen
400validation_errorfeedback is missing or is not thumbs_up/thumbs_down
404not_foundNo such message, or the message belongs to another project
Was this page helpful? Yes No
Request
bashJavaScriptPythonGoRubyPHPJavaC#bash
curl -X POST https://api.syntext.dev/v1/projects/3f2a9c1e-8b4d-4e7a-9c21-5d6e7f8a9b0c/chat/feedback/4f81d3b7-2c6e-4a1d-9b0f-7e5a3c2d1b90 \
-H "Content-Type: application/json" \
-d '{ "feedback": "thumbs_down" }'
Responseapplication/json
json
{ "ok": true }
Product
Resources
Company
© 2026 SyntextBuilt with Syntext