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

# Search Cast templates



## OpenAPI

````yaml /api/openapi.json post /api/v1/cast/templates/search
openapi: 3.0.2
info:
  title: Melius API
  version: '1'
  description: >-
    The Melius REST API. Authenticate with an API key as a bearer token
    (`Authorization: Bearer mel_...`) and select the team to act on with the
    `x-team-id` header. Generations run through the same node + run pipeline as
    the app: create a node on a canvas, start a run, poll the run, then read the
    resulting version asset.
servers:
  - url: https://api.melius.com
security:
  - apiKey: []
    teamId: []
paths:
  /api/v1/cast/templates/search:
    post:
      tags:
        - castTemplate
      summary: Search Cast templates
      operationId: castTemplate.search
      parameters: []
      requestBody:
        description: Body
        content:
          application/json:
            schema:
              type: object
              properties:
                pageSize:
                  type: integer
                  minimum: 0
                  exclusiveMinimum: true
                  maximum: 100
                  default: 25
                cursor:
                  type: string
                  minLength: 1
                  maxLength: 4096
                includeCount:
                  type: boolean
                  default: false
                tag:
                  type: string
                  minLength: 1
                  maxLength: 40
      responses:
        '200':
          description: '200'
          content:
            application/json:
              schema:
                allOf:
                  - type: object
                    properties:
                      data:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              format: uuid
                            title:
                              type: string
                              minLength: 1
                              maxLength: 200
                            description:
                              type: string
                              maxLength: 1000
                            tags:
                              type: array
                              items:
                                type: string
                            icon:
                              type: string
                              nullable: true
                              enum:
                                - speakerphone
                                - user-star
                                - microphone
                                - list-check
                                - package
                                - bell
                                - bulb
                                - seeding
                                - walk
                                - transform
                                - null
                            creation:
                              type: object
                              properties:
                                sections:
                                  type: array
                                  items:
                                    type: object
                                    properties:
                                      title:
                                        type: string
                                      text:
                                        type: string
                                      action:
                                        type: string
                                      kind:
                                        type: string
                                        enum:
                                          - action
                                      cutaway:
                                        type: boolean
                                        enum:
                                          - true
                                      seconds:
                                        type: integer
                                        minimum: 1
                                        maximum: 8
                                      speakerId:
                                        type: string
                                      continues:
                                        type: boolean
                                      inShot:
                                        type: array
                                        items:
                                          type: string
                                      scene:
                                        type: string
                                    required:
                                      - text
                                settings:
                                  type: object
                                  properties:
                                    videoStyle:
                                      type: object
                                      properties:
                                        id:
                                          type: string
                                          enum:
                                            - auto
                                            - self-filmed
                                            - produced
                                            - drama
                                            - vlog
                                            - podcast
                                            - unboxing
                                            - tutorial
                                            - announcement
                                            - explainer
                                            - founder-story
                                            - before-after
                                            - corporate-training
                                            - storytime
                                            - comment-reply
                                            - streamer-reaction
                                            - animated-3d
                                            - street-interview
                                        version:
                                          type: number
                                          enum:
                                            - 1
                                      required:
                                        - id
                                        - version
                                    speech:
                                      type: string
                                      enum:
                                        - on-screen
                                        - narration
                                    visuals:
                                      type: string
                                      enum:
                                        - auto
                                        - 'on'
                                        - 'off'
                                      description: >-
                                        Auto chooses useful supporting visuals
                                        from the script, actions and props
                                        across video styles, and may keep
                                        generated footage alone. Off skips added
                                        visuals. On remains accepted for
                                        compatibility. Subtitles are separate;
                                        generation eligibility still applies.
                                    pronunciations:
                                      type: array
                                      items:
                                        type: object
                                        properties:
                                          word:
                                            type: string
                                            minLength: 1
                                            maxLength: 200
                                          pronunciation:
                                            type: string
                                            minLength: 1
                                            maxLength: 200
                                        required:
                                          - word
                                          - pronunciation
                                      maxItems: 50
                                      description: >-
                                        Confirmed spoken spellings, e.g.
                                        [{"word":"Emmaus","pronunciation":"ee-may-us"}].
                                        Applied to speech only; keep the
                                        original spelling in the script and
                                        visual directions.
                                  required:
                                    - videoStyle
                                    - speech
                              required:
                                - sections
                                - settings
                            revision:
                              type: integer
                              minimum: -9007199254740991
                              maximum: 9007199254740991
                            position:
                              type: integer
                            isGlobal:
                              type: boolean
                            previewVideoUrl:
                              type: string
                              nullable: true
                              format: uri
                            thumbnailUrl:
                              type: string
                              nullable: true
                              format: uri
                            createdBy:
                              type: object
                              nullable: true
                              properties:
                                id:
                                  type: string
                                  format: uuid
                                name:
                                  type: string
                              required:
                                - id
                                - name
                            useCount:
                              type: integer
                              minimum: 0
                          required:
                            - id
                            - title
                            - description
                            - creation
                            - revision
                            - position
                            - isGlobal
                      pageSize:
                        type: integer
                        minimum: -9007199254740991
                        maximum: 9007199254740991
                      count:
                        type: integer
                        nullable: true
                        minimum: -9007199254740991
                        maximum: 9007199254740991
                      hasMore:
                        type: boolean
                      nextCursor:
                        type: string
                        nullable: true
                        minLength: 1
                        maxLength: 4096
                    required:
                      - data
                      - pageSize
                      - count
                      - hasMore
                      - nextCursor
                  - type: object
                    properties:
                      availableTags:
                        type: array
                        items:
                          type: string
        '400':
          description: '400'
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                required:
                  - message
        '401':
          description: Missing, invalid, expired, or revoked API key.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                  error:
                    type: string
                  message:
                    type: string
                required:
                  - statusCode
                  - message
        '403':
          description: '403'
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                required:
                  - message
        '429':
          description: Rate limit reached — retry after the `Retry-After` header.
          headers:
            Retry-After:
              description: Seconds to wait before retrying.
              schema:
                type: integer
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                  error:
                    type: string
                  message:
                    type: string
                  retryAfterSeconds:
                    type: integer
                required:
                  - statusCode
                  - message
components:
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: 'A Melius API key (`mel_...`), sent as `Authorization: Bearer <key>`.'
    teamId:
      type: apiKey
      in: header
      name: x-team-id
      description: The team (workspace) to act on. Defaults to the key's team when omitted.

````

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