Execute saved query

POST 
/v2/illuminate/queries/:id/execute

Executes a previously saved query by ID and returns the result set.

Usage

  • No request body required — send POST with an empty body or {}.
  • The saved definition is used as-is. To customize parameters (e.g. different time range), use the ad-hoc execute endpoint instead.

Response shape

Identical to ad-hoc execute:

FieldTypeDescription
dataarrayResult rows
executionTimenumberExecution duration in milliseconds
queryDefinitionobjectThe saved definition echoed back

Request​

Example
{
  "data": [
    {}
  ],
  "executionTime": 37,
  "queryDefinition": {
    "version": "2.0",
    "pipeline": {
      "sources": [
        {}
      ],
      "transforms": [
        {}
      ],
      "output": {
        "from": "event_aggregation",
        "select": [],
        "orderBy": [],
        "limit": 100,
        "offset": 0
      }
    },
    "meta": {}
  }
}