Discover the queryable LangWatchQL schema
import requests
url = "https://app.langwatch.ai/api/v1/query/schema"
headers = {"X-Auth-Token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Auth-Token': '<api-key>'}};
fetch('https://app.langwatch.ai/api/v1/query/schema', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));curl --request GET \
--url https://app.langwatch.ai/api/v1/query/schema \
--header 'X-Auth-Token: <api-key>'{
"database": "<string>",
"datasets": [
{
"name": "<string>",
"description": "<string>",
"grain": "<string>",
"joinKeys": [
"<string>"
],
"timeColumn": "<string>",
"freshness": "<string>",
"columns": [
{
"name": "<string>",
"type": "<string>",
"description": "<string>",
"unit": "ms",
"gates": [
"input"
],
"available": true
}
],
"exampleSql": "<string>"
}
]
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"meta": {},
"trace_id": "<string>",
"span_id": "<string>"
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"meta": {},
"trace_id": "<string>",
"span_id": "<string>"
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"meta": {},
"trace_id": "<string>",
"span_id": "<string>"
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"meta": {},
"trace_id": "<string>",
"span_id": "<string>"
}
}Query
Discover the queryable LangWatchQL schema
Lists the LangWatchQL analytics datasets this key may query, with each column’s type, description, the permissions that unlock it, and whether this caller holds them — plus each dataset’s grain, join keys, partition-pruning time column, freshness and a runnable example query.
Scoped to the credential’s own project and its permissions: a column this key cannot read is listed with available: false rather than hidden, so a caller can see what a wider key would unlock.
GET
/
api
/
v1
/
query
/
schema
Discover the queryable LangWatchQL schema
import requests
url = "https://app.langwatch.ai/api/v1/query/schema"
headers = {"X-Auth-Token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Auth-Token': '<api-key>'}};
fetch('https://app.langwatch.ai/api/v1/query/schema', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));curl --request GET \
--url https://app.langwatch.ai/api/v1/query/schema \
--header 'X-Auth-Token: <api-key>'{
"database": "<string>",
"datasets": [
{
"name": "<string>",
"description": "<string>",
"grain": "<string>",
"joinKeys": [
"<string>"
],
"timeColumn": "<string>",
"freshness": "<string>",
"columns": [
{
"name": "<string>",
"type": "<string>",
"description": "<string>",
"unit": "ms",
"gates": [
"input"
],
"available": true
}
],
"exampleSql": "<string>"
}
]
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"meta": {},
"trace_id": "<string>",
"span_id": "<string>"
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"meta": {},
"trace_id": "<string>",
"span_id": "<string>"
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"meta": {},
"trace_id": "<string>",
"span_id": "<string>"
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"meta": {},
"trace_id": "<string>",
"span_id": "<string>"
}
}Authorizations
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.
Last modified on August 31, 2026
Was this page helpful?