Skip to main content
Use these operations to interact with CQL queries in Cortex.
Starting November 10, 2026, POST /api/v1/queries no longer runs a query against every entity in your catalog. Pass up to 100 tags or Cortex IDs in entities, or page through the catalog with pageSize and pageToken. A request without entities runs against the first page of up to 1,000 entities, and its nextPageToken reads the next page.

​
Required permissions

Edit entities: Your API key must have the Enable Query builder permission.

​
Operations

Retrieve query results

GET /api/v1/queries/{jobId}

Run query

POST /api/v1/queries
Last modified on October 29, 2026