Skip to main content
POST
Query chart data
Use this route for chart field filters, date filters, variables, or refresh: true. The response uses the same PreparedData contract as the default chart route. Variables, date filters, forced refresh filters, and source refreshes require the Refresh data from sources key permission.

Authorizations

Authorization
string
header
required

A database-bound Data API key created in Team settings. Session and share tokens are not accepted.

Path Parameters

project_id
integer
required

Positive project ID in the API key's project access.

Required range: x >= 1
chart_id
integer
required

Positive chart ID in the project.

Required range: x >= 1

Body

application/json
variables
object

Runtime variable values. The default limit is 100 keys, 10 nested levels, and 8192 bytes per string. Variable names proto, constructor, and prototype are not accepted.

filters
object[]
Maximum array length: 50
refresh
boolean
default:false

Response

Prepared chart data. A GET can return a stale saved result while a refresh runs.

version
enum<integer>
required
Available options:
1
frameVersion
enum<integer>
required
Available options:
1
identityVersion
enum<integer>
required
Available options:
1
generatedAt
string<date-time>
required
resource
object
required
results
object[]
required
stats
object
required
warnings
(string | object)[]
required

A stable preparation warning.