Templates
- 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
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 itsidfromlistTemplates. Rollstack's own template has the fixed idrollstack-signature. Example:rollstack-signature.name(string, required): The template's name, as members see it in Rollstack.builtIn(boolean, required):truefor Rollstack's own template, which every organization has;falsefor a company template.source(string, required): Where the template comes from, as Rollstack shows it:Made by Rollstack,Shared by <member>orOnly 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.falsewhen only its creator can.nullfor Rollstack's own template.createdBy(object or null, required): The member who imported the company template.nullfor 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.nullfor 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 tofalse.
multipart/form-data
file(string (binary), required): The PowerPoint file, a.pptxof 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 itsidfromlistTemplates. Rollstack's own template has the fixed idrollstack-signature. Example:rollstack-signature.name(string, required): The template's name, as members see it in Rollstack.builtIn(boolean, required):truefor Rollstack's own template, which every organization has;falsefor a company template.source(string, required): Where the template comes from, as Rollstack shows it:Made by Rollstack,Shared by <member>orOnly 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.falsewhen only its creator can.nullfor Rollstack's own template.createdBy(object or null, required): The member who imported the company template.nullfor 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.nullfor 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 itsidfromlistTemplates. 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 itsidfromlistTemplates. Rollstack's own template has the fixed idrollstack-signature. Example:rollstack-signature.name(string, required): The template's name, as members see it in Rollstack.builtIn(boolean, required):truefor Rollstack's own template, which every organization has;falsefor a company template.source(string, required): Where the template comes from, as Rollstack shows it:Made by Rollstack,Shared by <member>orOnly 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.falsewhen only its creator can.nullfor Rollstack's own template.createdBy(object or null, required): The member who imported the company template.nullfor 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.nullfor 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 itsidfromlistTemplates. 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 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
templateId(string, required): The template, by itsidfromlistTemplates. Rollstack's own template has the fixed idrollstack-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 withrestoreReportVersionto 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.