> ## 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.

# Get a Cast template



## OpenAPI

````yaml /api/openapi.json get /api/v1/cast/templates/{id}
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/{id}:
    get:
      tags:
        - castTemplate
      summary: Get a Cast template
      operationId: castTemplate.get
      parameters:
        - in: path
          name: id
          schema:
            type: string
            format: uuid
          required: true
      responses:
        '200':
          description: '200'
          content:
            application/json:
              schema:
                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
        '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
        '404':
          description: '404'
          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.