Run a saved document query
Run one of a document’s saved queries and returns the results as JSON, CSV, or XLSX. The query is run as-is; only the result format is modifiable.
A tile the document’s dashboard shows, or any saved query on a document with an app, runs for anyone who can view the document — the same access check used for the dashboard’s own tiles. Any other saved query, such as a hidden tile or a tab that isn’t on the dashboard, requires access to the workbook itself.
Authorizations
Can be either an Organization API Key or Personal Access Token (PAT).
Include in the Authorization header as: Bearer YOUR_TOKEN
Path Parameters
Document identifier (either document ID or identifier slug)
"abc123"
The saved query to run: its queryIdentifierMapKey, or its query presentation id, from GET /api/v1/documents/{identifier}/queries.
1"1"
Query Parameters
Organization API key required. The membership ID of the user to act as.
Body
Whether to format result values (e.g., apply number formatting). Defaults to true.
Format of the result document. For csv and xlsx results formats, the document's Download setting must be enabled.
csv, xlsx, json "json"
Response
The saved query ran; the body is its result document.

