Add dashboard charts to report
- OpenAPI 3.1.0 document: https://api.rollstack.com/public/v1/openapi.json
- The whole reference in Markdown: https://docs.rollstack.com/llms-full.txt
- An index of the reference: https://docs.rollstack.com/llms.txt
POST https://api.rollstack.com/public/v1/reports/{id}/datasheets/{datasheetId}/elements
Adds charts of a Tableau view or Power BI page the report holds as a picture, each as a datasheet of its own: its data, to read with getReportDatasheetData or queryReportData and draw on a slide, its picture, or both. Pass the picture's datasheet id, from addReportDatasheets or listReportDatasheets, and the refs of the charts getReportDatasheet lists for it. Each chart is read with the dashboard's filters and the user's access to the connection, and a chart the report already reads that way is reused. Reading a dashboard can take a minute: past the wait the call answers that the source is still being read, so send the same call again, which reuses what the first one added. It runs one at a time with your queryReportData, previewReportDatasheetChanges and saveReportDatasheetChanges calls: send it once they answer. Only the report's editors may.
Requires the slide_decks:write scope.
Operation ID: addReportDashboardElements.
Path parameters
id(string, required): The report to act on, by itsidfromlistReportsorcreateReport. Only reports whosetypeisSlideDeckwork here: another type, such as a Google Slides presentation, returns400. You can also copy it from the report's link in Rollstack: it's the part right after/slides/.datasheetId(string, required): One of this report's datasheets, by itsidinlistReportDatasheets.
Headers
Idempotency-Key(string): A unique value, such as a UUID, that makes retrying this call safe. A retry with the same key within 24 hours answers the first call's result instead of running it again. Use a new key for each new call. From 1 to 255 printable ASCII characters.
Request body, required
application/json
elements(array of object, required): The charts to add, only the ones the slides need, at most 12 a call.ref(string, required): A chart'sreffrom theelementsgetReportDatasheetlists for this dashboard. For a table Tableau builds from several worksheets side by side, the refs of those worksheets joined by commas, like12,15,18, add it as one.as(string, required):datafor its table, to read withgetReportDatasheetDataand draw as a chart, table or figure on a slide;picturefor its image, to place on a slide as it looks;bothfor the two. Ask only for a read the element lists in itsreads. One ofdata,picture,both.
Response 200
Success
application/json
elements(array of object, required): Each chart you asked for, in the order ofelements.ref(string, required): Therefyou passed.name(string or null, required): The chart's name on the dashboard,nullwhen it has none.dataDatasheetId(string or null, required): The datasheet of its table, a new one or the one the report already had for this chart with the dashboard's filters.nullwhen you asked only for its picture, or when it was refused.pictureDatasheetId(string or null, required): The datasheet of its picture,nullwhen you asked only for its data, or when it was refused.error(string or null, required): Why it was refused, or why its data or picture could not be read,nullwhen nothing went wrong.