Set cloud save
- 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
PUT https://api.rollstack.com/public/v1/reports/{id}/cloud-export
Saves a report to a Google Drive, OneDrive or SharePoint folder after its runs, as the app's scheduling panel does, replacing the setting it had. Each save replaces the same file, or archives a dated copy first with archive. The folder is opened with the user's own Google or Microsoft account, which saves the report from then on. To save it now, start a run with startReportRun: a run that doesn't fail then tries to save it when trigger is all, and getReportCloudExport tells whether the save worked, since a failed save doesn't fail the run. Set trigger to none to stop saving it. Only its editors may.
Requires the slide_decks:write scope.
Operation ID: updateReportCloudExport.
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/.
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
provider(string, required): Where the report is saved:googlesaves it to Google Drive as a Google Slides presentation, with its charts as linked Google Sheets charts, andmicrosoftsaves it to OneDrive or SharePoint as a PowerPoint file with native charts. One ofgoogle,microsoft.folderUrl(string, required): The folder to save the report in, by its link: a Google Drive folder's link (or its id) withgoogle, or a OneDrive or SharePoint folder's link withmicrosoft. It's opened with your own Google or Microsoft account connected to Rollstack, which then saves the report, so you must be able to add files to it. Example:https://drive.google.com/drive/folders/1AbCdEfGh.fileName(string): The saved file's name. If omitted, the report's name.trigger(string, required): Which runs save it:allafter every run that doesn't fail,scheduledonly after the report's scheduled runs, andnonenever, which stops saving it and keeps the setting. One ofall,scheduled,none.updateMethod(string):updatereplaces the saved file with the new version.archivefirst copies the saved file, named with the date of its last save indatestampSuffix, then replaces it. Defaults toupdate. One ofupdate,archive.datestampSuffix(string): Howarchivedates the copies it keeps, as a moment.js format such asMM/DD/YYYYorYYYY-MM-DD. Defaults toMM/DD/YYYY.ignoreFailuresOnArchive(boolean): Witharchive, whether a copy that fails still lets the save go on. Defaults tofalse.
Response 200
Success
application/json
provider(string, required): Where the report is saved:googlesaves it to Google Drive as a Google Slides presentation, with its charts as linked Google Sheets charts, andmicrosoftsaves it to OneDrive or SharePoint as a PowerPoint file with native charts. One ofgoogle,microsoft.folder(object, required): The folder the report is saved in.id(string, required): The folder's id in Google Drive, OneDrive or SharePoint.name(string, required): The folder's name.
fileName(string, required): The saved file's name.trigger(string, required): Which runs save it:allafter every run that doesn't fail,scheduledonly after the report's scheduled runs, andnonenever, which stops saving it and keeps the setting. One ofall,scheduled,none.updateMethod(string, required):updatereplaces the saved file with the new version.archivefirst copies the saved file, named with the date of its last save indatestampSuffix, then replaces it. One ofupdate,archive,updateVisualizations.datestampSuffix(string, required): Howarchivedates the copies it keeps, as a moment.js format such asMM/DD/YYYYorYYYY-MM-DD.ignoreFailuresOnArchive(boolean, required): Witharchive, whether a copy that fails still lets the save go on.fileUrl(string or null, required): A link to the saved file, which its sharing in Google Drive, OneDrive or SharePoint lets people open.nulluntil it is first saved.runsAsUserId(number, required): The member whose Google or Microsoft account saves it, asidinlistMembers: the one who last chose its folder.lastStatus(string or null, required): Whether the last save worked.nulluntil it is first saved. A failed one emails the member it runs as. One ofsuccess,failed.lastStatusMessage(string or null, required): Why the last save failed.nullwhen it worked.lastExportedAt(string (date-time) or null, required): When the report was last saved.nulluntil it is first saved.