Create a key
A team owner or team admin can create a key in Team settings → API keys.- Enter a name.
- Select all projects in the team or specific projects.
- Keep Read chart and dataset data selected.
- Select Refresh data from sources if the client sends variables, date filters, or refreshes.
Read default data
/api/v1/teams/{team_id}/datasets/{dataset_id}/data.
Send runtime values
UsePOST when you need variables, filters, or a source refresh.
"Asia/Bangkok". Chart requests always
use the dashboard timezone.
Cache default reads
Save theETag from a successful GET, then send it with the next request.
304 with no body. X-Chartbrew-Data-Stale: true means Chartbrew
returned the last known chart data while it refreshes the source.
Use chart rows
Each chart result hasfields, series, and rows. Field keys describe the row properties. The
same response can drive any chart library.
Handle errors
All errors includeerror.code, a safe message, and error.requestId.
Do not retry
401, 403, or 404 until the key or request changes.