Skip to main content

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.