Skip to main content
POST
Preview draft variables

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

Resolve a draft set of variables that is not stored in any dashboard yet.

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.

variables
object[]
required

Draft variables, at most 20.

Maximum array length: 20

A dashboard variable. Pick the arm with kind.

selections
object
required

Selections keyed by variable name, at most 20 entries.

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.

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

Resolved draft variables. There is no dashboard_id because nothing is persisted.