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

# List Templates

> List all available content creation templates. Templates are optional — every content primitive works without one. When you do use a template, it provides a complete creative recipe: image prompts, video motion config, caption style rules, and edit operations. Returns template ID and description only — enough to pick the right one.



## OpenAPI

````yaml api-reference/openapi/content.json GET /api/content/templates
openapi: 3.1.0
info:
  title: Recoup API - Content
  description: >-
    API documentation for the Recoup platform - an AI agent platform for the
    music industry
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.recoupable.dev
security: []
paths:
  /api/content/templates:
    get:
      description: >-
        List all available content creation templates. Templates are optional —
        every content primitive works without one. When you do use a template,
        it provides a complete creative recipe: image prompts, video motion
        config, caption style rules, and edit operations. Returns template ID
        and description only — enough to pick the right one.
      responses:
        '200':
          description: Templates retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContentTemplatesResponse'
        '401':
          description: Unauthorized — invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContentErrorResponse'
      security:
        - apiKeyAuth: []
        - bearerAuth: []
components:
  schemas:
    ContentTemplatesResponse:
      type: object
      required:
        - templates
      description: List of available content creation templates.
      properties:
        templates:
          type: array
          items:
            $ref: '#/components/schemas/ContentTemplate'
    ContentErrorResponse:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          description: Error message describing what went wrong
          example: Unauthorized
    ContentTemplate:
      type: object
      required:
        - id
        - description
      description: >-
        A content creation template — a complete creative recipe defining visual
        style, composition, caption rules, and edit operations. Templates are
        optional; all primitives work without one.
      properties:
        id:
          type: string
          description: >-
            Template identifier. Pass this as the template field in content
            primitive requests or POST /api/content/create.
          example: artist-caption-bedroom
        description:
          type: string
          description: Human-readable description of the template's visual style
          example: >-
            Moody bedroom selfie. Artist on camera with deadpan expression,
            purple LED lighting, dark room. Short blunt captions in lowercase.
            Vertical 9:16 video, 8 seconds. Best for: introspective songs,
            vulnerable moments, daily content. Requires: face image, audio.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Your Recoup API key. [Learn more](/quickstart#api-keys).
    bearerAuth:
      type: http
      scheme: bearer

````