Skip to main content

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.