Skip to main content

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.