Skip to main content
POST
Run a LangWatchQL query

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
sql
string
required
Required string length: 1 - 50000
parameters
object
timeWindow
object
granularitySeconds

Response

The query ran. Columns, rows, execution statistics, truncation state and diagnostics, scoped to the caller's project.

columns
object[]
required
rows
object[]
required
statistics
object
required
truncated
boolean
required
followsTimeWindow
boolean
required
followsGranularity
boolean
required
diagnostics
object[]
required
granularitySeconds
number
coarsenedFromSeconds
number
Last modified on August 31, 2026