Skip to main content

Get burst settings

GET https://api.rollstack.com/public/v1/bursts/{id}/settings

A burst's settings, as its Settings tab in the app shows them: how its variants are named, and for an older report's burst, how each variant's run updates its file, what it does with empty charts, how it archives and how its filters match. Its folders and schedules are set in the app.

Requires the slide_decks:read scope.

Operation ID: getBurstSettings.

Path parameters

  • id (string, required): The burst to act on, by its id from listBursts. You can also copy it from the burst's link in Rollstack: it's the part right after /collections/.

Response 200

Success

application/json

  • kind (string, required): What the burst's variants differ by, as kind in listBursts. One of parameters, filters.
  • variantNaming (string, required): How each variant's report is named from the burst's name and the name the variant is added with, EMEA in a burst named Regional Review: suffix gives Regional Review - EMEA, prefix gives EMEA - Regional Review, and sameName gives EMEA. It applies to variants added from then on. One of sameName, prefix, suffix.
  • updateMethod (string, required): How each variant's run changes its file. update updates the same file with the latest data. archive first saves a copy of the file, named with the date of its previous run, then updates the original. updateVisualizations is the method email reports are created with. It applies to new variants and to the existing ones. For an older report's burst only: a Rollstack report's burst returns 400. One of update, archive, updateVisualizations.
  • variantEmptyVisualizations (string, required): What a variant's run does with a chart or table that has no data for its values. show places it empty, hideNoCascade leaves it out of the file, hideCascade hides its slide when every visualization on the slide is empty, and hideCascadeIfAtLeastOneVisualizationIsEmpty hides its slide when any of them is. For an older report's burst only: a Rollstack report's burst returns 400. One of show, hideNoCascade, hideCascade, hideCascadeIfAtLeastOneVisualizationIsEmpty.
  • archiveVariantsInFolder (boolean, required): With updateMethod archive: whether each variant's archived copies go in an archive folder next to its file, rather than beside it. For an older report's burst only: a Rollstack report's burst returns 400.
  • datestampSuffix (string, required): With updateMethod archive: the date format added to the name of each archived copy. For an older report's burst only: a Rollstack report's burst returns 400.
  • caseInsensitiveFilters (boolean, required): Whether a variant's filter values match the dashboard's values whatever their case. It applies when filters are next applied, such as with reapplyBurstFilters. For an older report's burst only: a Rollstack report's burst returns 400.