Execute an analytics query
POST /v1/query
Execute a SQL-like analytics query against telemetry data stored in ClickHouse.
Only SELECT statements are allowed. Queries are validated, rewritten to enforce
tenant isolation, and executed against a read-only connection.
Authorizations
Section titled “Authorizations ”Request Body required
Section titled “Request Body required ”object
The project ID to query.
SQL query (SELECT only).
Maximum number of rows to return.
Responses
Section titled “ Responses ”Query results.
object
Response payload (varies by endpoint).
Headers
Section titled “Headers ”Maximum number of requests allowed per hour.
Number of requests remaining in the current window.
Unix timestamp when the rate limit window resets.
Invalid request parameters or body.
object
Human-readable error message.
Missing or invalid API key.
object
Human-readable error message.
Rate limit exceeded.
object
Human-readable error message.
Headers
Section titled “Headers ”Maximum number of requests allowed per hour.
Number of requests remaining in the current window.
Unix timestamp when the rate limit window resets.
Query execution failed.
object
Human-readable error message.