Thumbs up/down events are used to capture user feedback on specific messages or interactions with your chatbot or LLM application, with an optional textual feedback.
You can use those user provided inputs in combination with the automatic sentiment analysis provided by LangWatch to gauge how satisfied your users are with the generated responses, and use this information to get insights, debug, iterate and improve your product.
To use the thumbs_up_down event it’s important that you have used an explicit trace_id defined on your side when doing the integration. Read more about it on concepts.
REST API Specification
Endpoint
POST /api/track_event
X-Auth-Token: Your LangWatch API key.
Request Body
Example
The vote metric is mandatory and must be either 1 or -1. The feedback field in event_details is optional and can be used to provide additional context or comments from the user. Last modified on October 29, 2026