Skip to main content
POST
Validate Query

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Api-key
string | null

Body

application/json
query
string
required

The SELECT SQL query to fetch the data.

with_stats
boolean
default:false

When true, respond with a stats envelope {rows, row_count, truncated, execution_ms} instead of a bare row list. truncated is exact (one extra row is probed), so clients computing aggregates can tell a capped result from a complete one.

folder_id
string<uuid> | null

Workspace folder context used as a preference when resolving unqualified table names across the workspace.

Response

Successful Response

query
string
required

SQL with table references rewritten to fully qualified BigQuery names.

ok
boolean
default:true
warnings
string[]
resolved_datasets
ResolvedDatasetRead · object[]