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

# List Stream Templates

> List the stream templates saved in your workspace.

## Overview

A stream template is a named snapshot of a previously created stream's
configuration, saved from the stream builder in the portal or with
[Create a Stream Template](create-template). Templates let you recreate a
proven setup, for example your matchday dubbing configuration, without
rebuilding the payload each time.

This endpoint returns every template saved in your workspace. Use
[Use a Stream Template](use-template) to retrieve a template's full payload.

Each workspace can hold at most 20 templates. When the limit is reached,
[delete a template](delete-template) before saving a new one.

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://client.camb.ai/apis/stream/templates/" \
    -H "x-api-key: YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://client.camb.ai/apis/stream/templates/",
      headers={"x-api-key": "YOUR_API_KEY"},
  )

  response.raise_for_status()
  print(response.json())
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "templates": [
      {
        "id": 12,
        "name": "matchday-dubbing",
        "stream_id": 4821
      },
      {
        "id": 15,
        "name": "press-conference",
        "stream_id": 5010
      }
    ]
  }
  ```
</ResponseExample>

## Related endpoints

* [Create a Stream Template](create-template)
* [Use a Stream Template](use-template)
* [Create Stream](create-new-stream)


## OpenAPI

````yaml get /stream/templates/
openapi: 3.1.0
info:
  title: FastAPI
  version: 0.1.0
servers:
  - url: https://client.camb.ai/apis
security: []
paths:
  /stream/templates/:
    get:
      tags:
        - Apis
        - Streaming
      summary: List Stream Templates
      description: >-
        List the stream templates saved in your workspace. A template is a named
        snapshot of a previously created stream's configuration. Retrieve its
        payload with Use a Stream Template.
      operationId: list_stream_templates_stream_templates__get
      responses:
        '200':
          description: The templates saved in your workspace.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListStreamTemplatesOut'
      security:
        - APIKeyHeader: []
components:
  schemas:
    ListStreamTemplatesOut:
      type: object
      title: ListStreamTemplatesOut
      required:
        - templates
      properties:
        templates:
          type: array
          title: Templates
          items:
            $ref: '#/components/schemas/StreamTemplateOut'
    StreamTemplateOut:
      type: object
      title: StreamTemplateOut
      required:
        - id
        - name
        - stream_id
      properties:
        id:
          type: integer
          title: Id
          description: The template id.
        name:
          type: string
          title: Name
          description: The template's name, unique within the workspace.
        stream_id:
          type: integer
          title: Stream Id
          description: The stream this template was saved from.
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        The `x-api-key` is a custom header required for authenticating requests
        to our API. Include this header in your request with the appropriate API
        key value to securely access our endpoints. You can find your API key(s)
        in the 'API' section of our studio website.

````