---
title: "List your templates"
method: GET
path: "/presets"
---

# List your templates

`GET /presets`

## Request

- Base URL: `https://rendry.io/api/v1`
- URL: `https://rendry.io/api/v1/presets`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer

One row per template, newest first. Read the ids carefully: a row's `id` is the LATEST VERSION and changes on every save; `preset_group_id` is the template — the value POST /presets returns as preset_id and the one every render, patch, share and delete-group door takes.

## Headers

- `X-Rendry-Account` string

## Response `200`

Templates

- PresetOverview[]
  - `id` string, required: The latest version's id
  - `user_id` string, required
  - `preset_group_id` string, required: The template's id — pass this to the render, patch, share and delete-group doors
  - `parent_id` string: The version the latest one was saved over
  - `name` string, required
  - `preview_url` string: Path of the preview picture, when one has been rendered
  - `is_public` boolean, required: Whether the template has a public link (GET /presets/{id}/share shows it)
  - `canvas` object
    - `width` integer
    - `height` integer
    - `output_format` string: Set when the first page is a document canvas
  - `sketch` object[]: Top-level layer boxes (t = layer type) for a thumbnail sketch before a preview exists
    - `t` string
    - `x` number
    - `y` number
    - `w` number
    - `h` number
  - `composition` object: Top-level layer count per type, e.g. {"text": 2, "image": 1}; group children are not counted
  - `version_note` string: Label of an explicitly marked version
  - `created_at` string, required
  - `updated_at` string, required

---

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