> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nedzo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Preview template

> Preview a public template via the Nedzo REST API. Returns its name, type, author, item counts, and required integrations, without the full content.

Preview a template before you import it. The response shows the template's name, type, author, how many items it holds, and which integrations it needs. It does not include prompts or workflow steps. [Get template](https://docs.nedzo.ai/api-reference/templates/get.md) returns the full content, but only for your own account's templates.

## Authentication

This endpoint needs no API key, and it works on every plan. It does not read the `Authorization` header, so it only shows public templates. A private template returns a `403`, even to the account that owns it.

## Path Parameters

**id** `string` *required*

Template UUID.

## Response

**id** `string`

Template UUID.

**name** `string`

Template name.

**description** `string | null`

Template description. `null` when the template has none.

**templateType** `string`

One of `agent`, `workflow`, or `workspace`.

**authorName** `string`

Name of the user who created the template. If the user has no name, this is their email. If no user is found, it is `Unknown`, or `Archived Account` when the template is archived.

**itemCounts** `object`

How many items the template holds. If the template data can't be read, every value is `0` and the request still succeeds.

**properties**

**agents** `integer`

Number of agents.

**workflows** `integer`

Number of workflows.

**customFields** `integer`

Number of custom fields.

**tags** `integer`

Number of tags.

**integrations** `array`

Integrations the template needs. Empty when it needs none.

**properties**

**id** `string`

Integration ID.

**displayName** `string`

Integration name to show to users.

**createdAt** `string`

When the template was created (ISO 8601).

## Errors

| Status | Detail | Cause |
| - | - | - |
| `400` | `Request validation failed for: param.id.` | `id` is not a valid UUID. `errors[0].message` is `Invalid template ID format`. |
| `403` | `This template is private` | The template is private. This endpoint only shows public templates. |
| `404` | `Template not found` | No template has this ID, or it was deleted. |

```bash cURL theme={null}
curl -X GET "https://api.nedzo.ai/v1/templates/123e4567-e89b-12d3-a456-426614174000/preview"
```

```json Response theme={null}
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Sunrise Dental Front Desk",
  "description": "A voice agent that books dental appointments",
  "templateType": "agent",
  "authorName": "Jane Doe",
  "itemCounts": {
    "agents": 1,
    "workflows": 0,
    "customFields": 0,
    "tags": 0
  },
  "integrations": [],
  "createdAt": "2026-01-15T10:30:00Z"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.