Skip to main content

Templates

The look a slide deck is built in: its theme, slide masters, layouts and slide size. Members import their company's templates from PowerPoint or Google Slides in the app, keep them to themselves or share them with the organization, and every organization also has Rollstack's own.

List the ones the user can use with listTemplates, start a new report in one with templateId in createReport, or switch an existing report to one with applyReportTemplate.

Import a company template from a Google Slides presentation or a PowerPoint file with createTemplate, rename it or share it with the organization with updateTemplate, and delete it with deleteTemplate.

List templates

GET https://api.rollstack.com/public/v1/templates

The templates the user can build a slide deck in: their company's, with who imported each and whether it is shared with the organization, then Rollstack's own. Pass a template's id as templateId to createReport or applyReportTemplate.

Requires the slide_decks:read scope.

Operation ID: listTemplates.

Response 200

Success

application/json

  • data (array of object, required): The templates the user can use: the company templates they imported or that are shared with the organization, newest first, then Rollstack's own. Members import and share them in Rollstack, in the Templates drawer of a report.
    • id (string, required): The template, by its id from listTemplates. Rollstack's own template has the fixed id rollstack-signature. Example: rollstack-signature.
    • name (string, required): The template's name, as members see it in Rollstack.
    • builtIn (boolean, required): true for Rollstack's own template, which every organization has; false for a company template.
    • source (string, required): Where the template comes from, as Rollstack shows it: Made by Rollstack, Shared by <member> or Only visible to you. Name it to tell templates with the same name apart.
    • sharedWithOrganization (boolean or null, required): Whether everyone in the organization can use the company template. false when only its creator can. null for Rollstack's own template.
    • createdBy (object or null, required): The member who imported the company template. null for Rollstack's own, or when their account was deleted.
      • id (number, required)
      • name (string, required)
    • createdAt (string (date-time) or null, required): When the company template was imported. null for Rollstack's own.

Import template

POST https://api.rollstack.com/public/v1/templates

Imports a company template from a Google Slides presentation, as the app's Templates drawer does: its theme, slide masters, layouts and slide size, not its slides. The presentation is read with the user's Google account connected to Rollstack. Over REST, you can instead send a PowerPoint file as multipart/form-data in the file field: a .pptx of at most 100 MB, named after the file and kept to the user until shared with updateTemplate. Answers the template as listTemplates lists it, to pass as templateId to createReport or applyReportTemplate.

Requires the slide_decks:write scope.

Operation ID: createTemplate.

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

  • name (string, required): The template's name, as members will see it in Rollstack. Example: Acme 2026.
  • googleSlidesId (string, required): The Google Slides presentation to import the look of, by its link or its id: the part after /presentation/d/ in the link. It's read with your Google account connected to Rollstack, so you must be able to open it.
  • sharedWithOrganization (boolean): Whether everyone in the organization can use the template, or only you. Only admins can share a template with the organization; a template's creator can stop sharing it. Defaults to false.

multipart/form-data

  • file (string (binary), required): The PowerPoint file, a .pptx of at most 100 MB. The endpoint says what it takes from the file and how it names what it makes.

Response 201

Success

application/json

  • id (string, required): The template, by its id from listTemplates. Rollstack's own template has the fixed id rollstack-signature. Example: rollstack-signature.
  • name (string, required): The template's name, as members see it in Rollstack.
  • builtIn (boolean, required): true for Rollstack's own template, which every organization has; false for a company template.
  • source (string, required): Where the template comes from, as Rollstack shows it: Made by Rollstack, Shared by <member> or Only visible to you. Name it to tell templates with the same name apart.
  • sharedWithOrganization (boolean or null, required): Whether everyone in the organization can use the company template. false when only its creator can. null for Rollstack's own template.
  • createdBy (object or null, required): The member who imported the company template. null for Rollstack's own, or when their account was deleted.
    • id (number, required)
    • name (string, required)
  • createdAt (string (date-time) or null, required): When the company template was imported. null for Rollstack's own.

Update template

PATCH https://api.rollstack.com/public/v1/templates/{templateId}

Renames a company template, or shares it with the organization or stops sharing it, as the app's Templates drawer does. Its creator can rename it and stop sharing it, only an admin can share their own template with the organization, and admins can also rename any shared one. Reports already built in it keep their look. Answers the template as listTemplates lists it.

Requires the slide_decks:write scope.

Operation ID: updateTemplate.

Path parameters

  • templateId (string (uuid), required): The company template to act on, by its id from listTemplates. Rollstack's own template can't be changed.

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

  • name (string): The template's new name, as members see it in Rollstack.
  • sharedWithOrganization (boolean): Whether everyone in the organization can use the template, or only you. Only admins can share a template with the organization; a template's creator can stop sharing it.

Response 200

Success

application/json

  • id (string, required): The template, by its id from listTemplates. Rollstack's own template has the fixed id rollstack-signature. Example: rollstack-signature.
  • name (string, required): The template's name, as members see it in Rollstack.
  • builtIn (boolean, required): true for Rollstack's own template, which every organization has; false for a company template.
  • source (string, required): Where the template comes from, as Rollstack shows it: Made by Rollstack, Shared by <member> or Only visible to you. Name it to tell templates with the same name apart.
  • sharedWithOrganization (boolean or null, required): Whether everyone in the organization can use the company template. false when only its creator can. null for Rollstack's own template.
  • createdBy (object or null, required): The member who imported the company template. null for Rollstack's own, or when their account was deleted.
    • id (number, required)
    • name (string, required)
  • createdAt (string (date-time) or null, required): When the company template was imported. null for Rollstack's own.

Delete template

DELETE https://api.rollstack.com/public/v1/templates/{templateId}

Deletes a company template, as the app's Templates drawer does. Reports already built in it keep their look; new ones can no longer start in it. Its creator, or an admin for a shared one, may.

Requires the slide_decks:write scope.

Operation ID: deleteTemplate.

Path parameters

  • templateId (string (uuid), required): The company template to act on, by its id from listTemplates. Rollstack's own template can't be changed.

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.

Response 204

Success, no content

Apply template

POST https://api.rollstack.com/public/v1/reports/{id}/template

Switches a report of type SlideDeck to a template's theme, slide masters, layouts and slide size, as the Templates drawer in the app does. Its slides keep their content and move to the template's matching layouts; the answer names the slides that had no match, and the version saved just before as versionBeforeId: restore it with restoreReportVersion to undo the change. Only its editors may, and not while the report is running or the slides agent is working on it.

Requires the slide_decks:write scope.

Operation ID: applyReportTemplate.

Path parameters

  • id (string, required): The report to act on, by its id from listReports or createReport. Only reports whose type is SlideDeck work here: another type, such as a Google Slides presentation, returns 400. 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

  • templateId (string, required): The template, by its id from listTemplates. Rollstack's own template has the fixed id rollstack-signature. Example: rollstack-signature.

Response 200

Success

application/json

  • templateName (string, required): The name of the template the report now uses.
  • versionName (string, required): The name of the version of the report saved just before, in its Version history.
  • versionBeforeId (string, required): The version saved just before. Restore it with restoreReportVersion to undo the change.
  • closestLayoutSlides (array of integer, required): The slides, by number from 1, whose layout the template has no match for: they moved to the template's closest layout, so tell the user to check them.
  • noLayoutSlides (array of integer, required): The slides, by number from 1, with no layout, such as ones pasted from PowerPoint: they only got the template's colors and fonts.