---
title: Templates API - List Carousel Templates
description: List the carousel templates available to your workspace with the PostNitro Embed API. Returns template id, name, and size for use in carousel generation.
canonical: https://postnitro.ai/docs/embed/api/templates
---

# Templates

A **template** defines the visual layout and size used when generating a
carousel. Use this endpoint to discover the templates available in your
workspace, then reference a template id when generating designs.

Requires the `embed-api-key` header — see
[Authentication](https://postnitro.ai/docs/embed/api/authentication).

---

## List templates

```
GET /template
```

Returns templates in your workspace, most recently updated first.

### Query parameters

| Parameter | Default | Description |
| --- | --- | --- |
| `page` | `1` | Page number (positive integer). |
| `limit` | `10` | Items per page (`1`–`100`). |

### Response `200`

```jsonc
{
  "success": true,
  "data": {
    "templates": [
      {
        "id": "template_123",
        "name": "Bold Headlines",
        "size": "1080x1350"
      }
    ]
  }
}
```

| Field | Description |
| --- | --- |
| `id` | Template id — pass this when generating a carousel. |
| `name` | Human-readable template name. |
| `size` | The template's canvas size. |

### Errors

| Status | Body | When |
| --- | --- | --- |
| `404` | `{ "success": false, "message": "No templates found" }` | The workspace has no templates. |
| `422` | `{ "status": false, "message": "Page must be a positive integer" }` | Invalid `page`. |
| `422` | `{ "status": false, "message": "Limit must be between 1 and 100" }` | Invalid `limit`. |
| `500` | `{ "success": false, "message": "Error fetching Templates", ... }` | Unexpected server error. |

See [Authentication](https://postnitro.ai/docs/embed/api/authentication) for `401` / `402` responses.