Skip to main content

Documentation Index

Fetch the complete documentation index at: https://langwatch.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

Waited to finish events are used to determine if users are waiting for the LLM application to finish generating a response or if they leave before it’s completed. This is useful for capturing user impatience with regards to the response generation. Since the user can simply close the window, to track this behavior, you need to send two requests: first with finished set as 0 to identify the output has started, and another one with finished set as 1 when the output finishes at client side. If "finished": 1 is never received, LangWatch assumes the user didn’t let the AI finish.

​
REST API Specification

​
Endpoint

POST /api/track_event

​
Headers

  • X-Auth-Token: Your LangWatch API key.

​
Request Body

{
  "trace_id": "id of the message the user gave the feedback on",
  "event_type": "waited_to_finish",
  "metrics": {
    "finished": 0 // Call it with 0 on the first request, then with 1 after the messages finishes rendering
  },
  "timestamp": 1617981376000 // Unix timestamp in milliseconds
}

​
Example

curl -X POST "https://app.langwatch.ai/api/track_event" \\
     -H "X-Auth-Token: your_api_key" \\
     -H "Content-Type: application/json" \\
     -d '{
       "trace_id": "trace_Yy0XWu6BOwwnrkLtQh9Ji",
       "event_type": "waited_to_finish",
       "metrics": {
         "finished": 0
       },
       "timestamp": 1617981376000
     }'

curl -X POST "https://app.langwatch.ai/api/track_event" \\
     -H "X-Auth-Token: your_api_key" \\
     -H "Content-Type: application/json" \\
     -d '{
       "trace_id": "trace_Yy0XWu6BOwwnrkLtQh9Ji",
       "event_type": "waited_to_finish",
       "metrics": {
         "finished": 1
       },
       "timestamp": 1617981378000
     }'