Skip to main content
POST
Preview draft panel

Authorizations

app_key
string
query
required

App key issued from the Flashduty console under Account → APP Keys. Required on every public API call. Keep it secret — it grants the same access as the owning account.

Body

application/json

Execute a draft panel inline, without saving a dashboard revision. Subject to the same 1 MiB definition-size ceiling.

context
object
required

Where an unsaved draft panel or variable set belongs. existing targets a stored dashboard, new a folder that does not contain one yet — the two are mutually exclusive.

panel
object
required

A single visualization. Panels must not overlap inside the same container; the 24-column grid is validated on save.

variables
object[]
required

Draft variables the panel may reference.

Maximum array length: 20

A dashboard variable. Pick the arm with kind.

selections
object
required

Selections keyed by variable name.

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.

max_data_points
integer | null

Downsampling target, 2–5000 points.

Required range: 2 <= x <= 5000

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
required

Draft panel execution result. Same shape as a stored panel run, minus the dashboard identity.