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

# List builder templates

> GET /v1/embed/builder/templates — list a partner project's templates. Partner API key only.

<Info>**GET** `https://api.craftkit.dev/v1/embed/builder/templates`</Info>

Returns every non-deleted template in the authenticated partner's project, newest-updated first.
Lightweight — identifiers plus the draft `category`, not the full draft.

## Authorization

Partner API key **only**. A session JWT is **not** accepted here.

<ParamField header="Authorization" type="string" required>
  `Bearer ck_live_…` — a project API key for a project with the embed partner enabled.
</ParamField>

## Response

<ResponseField name="templates" type="object[]">
  <Expandable title="template">
    <ResponseField name="id" type="string" />

    <ResponseField name="name" type="string" />

    <ResponseField name="slug" type="string">URL-safe slug (name-derived, random-suffixed).</ResponseField>

    <ResponseField name="createdAt" type="string" />

    <ResponseField name="updatedAt" type="string" />

    <ResponseField name="category" type="string | null">The draft's `category`, if set.</ResponseField>
  </Expandable>
</ResponseField>

## Errors

| Status | code                    | Meaning                                                           |
| ------ | ----------------------- | ----------------------------------------------------------------- |
| 401    | `missing_authorization` | No `Authorization` header.                                        |
| 401    | `invalid_credentials`   | API key not found, revoked, or embed not enabled for the project. |

```bash cURL theme={null}
curl https://api.craftkit.dev/v1/embed/builder/templates \
  -H "Authorization: Bearer $CRAFTKIT_API_KEY"
```

```json 200 theme={null}
{
  "templates": [
    {
      "id": "0193c2c3-...",
      "name": "Charter Handover",
      "slug": "charter-handover-1a2b3c4d",
      "createdAt": "2026-05-01T09:00:00.000Z",
      "updatedAt": "2026-06-01T12:00:00.000Z",
      "category": "charter"
    }
  ]
}
```