Skip to main content
POST
Resolve panel queries

Restrictions

Usage

  • Use this to show which datasource a panel will hit, and with which expression, before running it. Nothing is executed.
  • panel_ids accepts 1–100 unique IDs, answered in request order. A panel that is not in the dashboard yields state: "error" with reason panel_missing instead of failing the call; a text panel yields state: "error" with reason invalid_request.
  • state is success when every query of the panel resolved, partial when only some did, and error when none did. queries lists the queries that resolved; error reports only the first failure.
  • Built-in time variables (such as the step and the time range) are rendered from time and max_data_points, unless preserve_builtin_variables is true, which leaves them verbatim for a caller that renders them with its own window. User variables are always resolved.
  • Panel queries can only be bound to Prometheus, MySQL and Loki datasources. The call has a 35-second overall deadline; exceeding it returns RuntimeTimeout (HTTP 504).

Authorizations

app_key
string
query
required

APP Key created in the Flashduty console under My → APP Key. Send it as the app_key query parameter or in the Fd-App-Key request header. Its effective access is the intersection of the key's permission scope and the creator's current role permissions. Keep it secret.

Body

application/json

Resolve the queries of selected panels without executing them, so a client can preview datasource binding and variable substitution.

dashboard_id
string
required

Canonical UUIDv7 of the dashboard.

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
panel_ids
string[]
required

Panels to resolve, 1–100 unique IDs. A panel that does not exist yields an error arm rather than failing the call.

Required array length: 1 - 100 elements
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
time
object
required

Absolute evaluation window. Both bounds are Unix timestamps in milliseconds, from_ms must be less than to_ms, and neither may exceed the JavaScript safe integer limit.

variables
object

Selections keyed by variable name, at most 20 entries. Variables without an entry fall back to their stored defaults; a name the dashboard does not define fails the call with HTTP 400.

max_data_points
integer | null

Target maximum number of points per series, used to compute the step and render the built-in time variables. 2–5000; omit or send null for the default of 100.

Required range: 2 <= x <= 5000
preserve_builtin_variables
boolean

Keep built-in time variables verbatim in the resolved expressions so a caller with its own execution window can render them; user variables are still resolved.

Response

Success

Success response envelope. On every 2xx response, request_id identifies the call (also mirrored in the Flashcat-Request-Id header) and data holds the endpoint-specific payload. Failure responses use a different shape — see ErrorResponse.

request_id
string
required

Unique ID for this request. Mirrored in the Flashcat-Request-Id response header. Include it when reporting issues.

Example:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

data
object

Resolved queries of the requested panels, plus the effective variable selections they were resolved with. Nothing is executed.