# List briefing templates

`GET https://api.cream-ai.de/api/v1/templates`

Active briefing templates of the company, created by people in mint. Use the `key` as `template` in `POST /films`. `settings` shows only the template values that `POST /films` also accepts in `settings`; the template may set further mint settings (for example music, depth or audience), which apply as well. Sorted by `name` (without case), then `key`. Changes in mint appear immediately.

Scopes: `catalog:read`

## Parameters

- `limit` (query): Page size (1–100).
- `cursor` (query): Opaque cursor from next_cursor of the previous page.

## Returns

- 200: One page of the list.

## Errors

- 400: Invalid request (invalid_request, invalid_json, invalid_cursor, idempotency_key_required, invalid_idempotency_key, parent_not_found, max_depth_exceeded, narration_too_long, user_not_in_company, template_not_found, category_not_found, feedback_kind_unsupported, upload_not_found).
- 401: Missing, malformed, revoked or expired API key (unauthorized).
- 403: Not allowed (forbidden_scope, ip_not_allowed, company_inactive, api_not_enabled).
- 404: Not found (not_found).
- 429: Too many requests (rate_limited).
- 500: Internal error (internal). Quote the request id when you contact support.
- 503: Temporarily unavailable (service_unavailable). Retry later (after Retry-After seconds, if sent).

## Example request

```sh
curl "https://api.cream-ai.de/api/v1/templates" \
  -H "Authorization: Bearer $MINT_API_KEY"
```

## Example response (200)

```json
{
  "object": "list",
  "data": [
    {
      "object": "template",
      "id": "tpl_51",
      "key": "lesson-standard",
      "name": "Lesson – standard",
      "language": "de",
      "settings": {
        "format": "16x9",
        "style_id": "b6ed57e1-2c4f-4b8a-9d3e-6f1a0c2b7e45",
        "brand_id": "brand-northwind-x7k2p9",
        "voice_id": "Xb7hH8MSUJpSbSDYk0k2",
        "narration_mode": "verbatim",
        "tempo": "presenting",
        "freedom": 40,
        "video_share": 25,
        "target_duration_s": 180
      },
      "updated_at": "2026-10-30T16:20:00Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}
```