---
title: "The account's saved render templates"
method: GET
path: "/templates"
tags: ["templates"]
---

# The account's saved render templates

`GET /templates`

## Request

- Base URL: `https://api.gogoscreen.com/api/v1`
- URL: `https://api.gogoscreen.com/api/v1/templates`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Every render template this account has saved, most recently updated first. System templates are not here — `catalog.renderOptions` lists those, and both kinds of id are accepted wherever a `templateId` is taken.

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

The account's saved render templates

- object
  - `nextCursor` string, nullable, required: Pass as `cursor` for the next page; null on the last page.
  - `templates` object[], required
    - `background` string, nullable, required
    - `captureId` string, nullable, required
    - `custom` boolean, required: true for one of this account's saved templates, false for a system template.
    - `description` string, required
    - `id` string, required
    - `isDefault` boolean, required
    - `language` string, nullable, required
    - `lengthPreset` string, nullable, required
    - `limits` object, nullable, required: The engine limits this template pins. Open shape, may gain keys; ≤65536 bytes, ≤16 deep.
    - `name` string, required
    - `orientationId` string, nullable, required
    - `sourceRenderId` string, nullable
    - `speedFactor` number, nullable: System templates only: a factor on the voice's own speed.
    - `ttsSpeed` number, nullable, required
    - `updatedAt` string, date-time, nullable
    - `voiceId` string, nullable, required
    - `voiceStyle` string, nullable: System templates only: the delivery the narrator reads in.

## Other responses

- `400`: `validation_failed` — That request is not valid. · `invalid_cursor` — That page cursor is not valid.
- `401`: `unauthorized` — Authentication is required.
- `403`: `forbidden_scope` — This credential does not carry the scope this operation needs.
- `404`: `not_found` — No such resource.
- `429`: `rate_limited` — Too many requests. Try again shortly.
- `500`: `internal_error` — Something went wrong. Try again.

---

[API](https://skmtc.dev/gogoscreen/apis/gogoscreen-api.md) · [All operations](https://skmtc.dev/gogoscreen/apis/gogoscreen-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gogoscreen/apis/gogoscreen-api/revisions/2fd812319d75?raw)