---
title: "List a template's versions"
method: GET
path: "/api/v1/templates/{id}/versions"
tags: ["Template Management"]
---

# List a template's versions

`GET /api/v1/templates/{id}/versions`

## Request

- Base URL: `https://api.imagestep.dev`
- URL: `https://api.imagestep.dev/api/v1/templates/{id}/versions`
- Auth: API key in header `Authorization`

Every version ever saved, newest first, each as a full document — html and css included — whose
`id` is `{id}@{version}` and which has no `slug`, `description` or `updatedAt`. Not paged: a
template's history is one answer. A built-in answers with its one current document.

## Path parameters

- `id` string, required

## Response `200`

Every version, newest first

## Other responses

- `404`: `not_found` on `templateId` — no such template, or it is not yours
- `429`: Rate limited — `error.code` is `rate_limited` and `retryable` is true. `Retry-After` says how many seconds to wait.

---

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