Record a user event

import requests

url = "https://app.langwatch.ai/api/v1/events/track"

payload = {
    "event_type": "<string>",
    "metrics": {},
    "trace_id": "<string>"
}
headers = {
    "X-Auth-Token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-Auth-Token': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({event_type: '<string>', metrics: {}, trace_id: '<string>'})
};

fetch('https://app.langwatch.ai/api/v1/events/track', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

curl --request POST \
  --url https://app.langwatch.ai/api/v1/events/track \
  --header 'Content-Type: application/json' \
  --header 'X-Auth-Token: <api-key>' \
  --data '
{
  "event_type": "<string>",
  "metrics": {},
  "trace_id": "<string>"
}
'

{
  "message": "Event tracked"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

POST

api

events

track

Record a user event

import requests

url = "https://app.langwatch.ai/api/v1/events/track"

payload = {
    "event_type": "<string>",
    "metrics": {},
    "trace_id": "<string>"
}
headers = {
    "X-Auth-Token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-Auth-Token': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({event_type: '<string>', metrics: {}, trace_id: '<string>'})
};

fetch('https://app.langwatch.ai/api/v1/events/track', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

curl --request POST \
  --url https://app.langwatch.ai/api/v1/events/track \
  --header 'Content-Type: application/json' \
  --header 'X-Auth-Token: <api-key>' \
  --data '
{
  "event_type": "<string>",
  "metrics": {},
  "trace_id": "<string>"
}
'

{
  "message": "Event tracked"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

Authorizations

X-Auth-Token

string

header

required

Project API key for sending traces and accessing project-scoped resources. Format: sk-lw-... (no underscore). Obtain one by creating a project via the Admin API or the LangWatch UI.

Body

application/json

event_type

string

required

metrics

object

required

Show child attributes

trace_id

string

required

event_id

string

event_details

object

Show child attributes

timestamp

number

Response

Event tracked

message

string

required

Allowed value: "Event tracked"

Last modified on October 12, 2026