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

# Read template

> Read a saved template.



## OpenAPI

````yaml /openapi.json get /templates/{slug}
openapi: 3.1.0
info:
  title: Motion
  version: 1.1.0
  description: >-
    Create Motion projects from prompts, read authored generations and outputs,
    and explicitly request renders or editor exports. Use reusable templates and
    brand kits. Credentials remain bound to current workspace access and
    permissions. Legacy single-video endpoints are deprecated.
servers:
  - url: https://api.motion.so/api/motion
security:
  - MotionApiKey: []
tags:
  - name: Projects
  - name: Project results
  - name: Project exports
  - name: Templates
  - name: Brand kits
  - name: Media library
  - name: Automations
  - name: Social posting
  - name: API information
  - name: Deprecated endpoints
    description: >-
      Older single-video routes remain callable for existing clients. Use the
      project API for new integrations; no removal date is scheduled.
  - name: Connectors
    description: Connect services and control the actions a project may use.
paths:
  /templates/{slug}:
    get:
      tags:
        - Templates
      summary: Read template
      description: Read a saved template.
      operationId: ReadTemplate
      parameters:
        - name: slug
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MotionGetVisualTemplateResponse'
              example:
                template:
                  id: launch-film
                  title: Product launch
                  kind: video
                  mode: style
                  editable: true
                  version_id: null
                  instructions: Use the saved layout and adapt the text to the new brief.
                  width: null
                  height: null
                  duration_seconds: null
                  preview_status: preparing
                  preview_url: null
                  thumbnail_url: null
                  brand_kit_id: null
                  default_brand_kit_available: true
                  generation_id: null
                  created_at: null
                  resource_url: /api/motion/templates/launch-film
        '400':
          description: Invalid input or cursor
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Credential invalid or revoked
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Missing scope, role, resource access or entitlement
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Resource not visible
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '409':
          description: Stale revision, active work or conflicting source identity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: Required service unavailable; do not blindly retry mutations
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - MotionApiKey: []
        - MotionOAuth:
            - motion:templates:read
components:
  schemas:
    MotionGetVisualTemplateResponse:
      type: object
      properties:
        template:
          type: object
          properties:
            id:
              type: string
              description: >-
                Identifier of this resource. Use it when reading or updating the
                same resource.
            title:
              type: string
              description: Human-readable template name chosen when saving the resource.
            kind:
              type: string
              enum:
                - video
                - image
              description: >-
                Resource kind or authored output type as specified by this
                response.
            mode:
              type: string
              enum:
                - style
                - layout_and_style
              description: >-
                Template reuse mode: style adapts its visual language;
                layout_and_style also preserves the saved structure.
            editable:
              type: boolean
              description: >-
                True for a saved editable project. False means this template
                stores a media reference.
            version_id:
              type:
                - string
                - 'null'
              description: >-
                Current immutable saved template version, or null when
                unavailable.
            instructions:
              type: string
              description: >-
                Saved directions for future uses of this template; source
                conversion does not apply them as an edit.
            width:
              type:
                - number
                - 'null'
              description: Template canvas width in pixels.
            height:
              type:
                - number
                - 'null'
              description: Template canvas height in pixels.
            duration_seconds:
              type:
                - number
                - 'null'
              description: Template or media usage duration in seconds.
            preview_status:
              type: string
              enum:
                - preparing
                - ready
                - failed
              description: >-
                Template preview preparation state: preparing, ready or failed.
                Saving and preview rendering finish independently.
            preview_url:
              anyOf:
                - type: string
                  format: uri
                - type: 'null'
              description: >-
                Expiring authorized video-preview URL, or null until a video
                preview is available.
            thumbnail_url:
              anyOf:
                - type: string
                  format: uri
                - type: 'null'
              description: >-
                Expiring authorized image-preview URL, or null until a preview
                is available.
            brand_kit_id:
              anyOf:
                - type: string
                  format: uuid
                - type: 'null'
              description: Default brand-kit UUID saved with this template, or null.
            default_brand_kit_available:
              type: boolean
              description: >-
                Whether the saved template’s default kit remains accessible to
                this credential.
            generation_id:
              anyOf:
                - type: string
                  format: uuid
                - type: 'null'
              description: >-
                Saved project version used as the source. Null when not
                recorded.
            created_at:
              anyOf:
                - type: string
                  format: date-time
                - type: 'null'
              description: ISO 8601 timestamp when this resource was created.
            resource_url:
              type: string
              description: Authenticated API route to read this exact saved resource.
          required:
            - id
            - title
            - kind
            - mode
            - editable
            - version_id
            - instructions
            - width
            - height
            - duration_seconds
            - preview_status
            - preview_url
            - thumbnail_url
            - brand_kit_id
            - default_brand_kit_available
            - generation_id
            - created_at
            - resource_url
          additionalProperties: false
          description: Saved template, current version and preview status.
      required:
        - template
      additionalProperties: false
    ErrorResponse:
      type: object
      description: >-
        Error bodies are JSON. Check the HTTP status first. Permission and
        validation errors use error; service errors may use detail. Optional
        fields explain how to correct the request.
      anyOf:
        - required:
            - error
        - required:
            - detail
      properties:
        error:
          type: string
          description: Error code or readable explanation.
        detail:
          type: string
          description: Readable explanation from the service.
        message:
          type: string
          description: Readable explanation accompanying an error code.
        error_description:
          type: string
          description: Authentication or permission explanation.
        required_scope:
          type: string
          description: Permission required by this operation.
        details:
          type: array
          description: Invalid request fields. Each issue includes a path and message.
          items:
            type: object
            properties:
              code:
                type: string
              path:
                type: array
                items:
                  oneOf:
                    - type: string
                    - type: integer
              message:
                type: string
        issues:
          type: array
          description: Service validation issues.
          items:
            type: object
  securitySchemes:
    MotionApiKey:
      type: http
      scheme: bearer
      description: >-
        A Motion API key. Access is limited to its stored organization,
        workspace, scopes and the creator’s current permissions.
    MotionOAuth:
      type: oauth2
      description: >-
        OAuth REST tokens use the full MCP audience, https://mcp.motion.so/mcp.
        Reauthorize existing connections to add scopes. Current workspace roles
        and resource permissions still apply.
      flows:
        authorizationCode:
          authorizationUrl: https://mcp.motion.so/oauth/authorize
          tokenUrl: https://mcp.motion.so/oauth/token
          scopes:
            motion:automations:read: Read automation definitions, capabilities, runs, and analytics.
            motion:automations:write: Create, edit, delete, invoke, and retry automations.
            motion:connectors:read: >-
              Read available services, your private organization connections and
              allowed actions without secrets.
            motion:connectors:write: >-
              Connect and disconnect your private accounts inside the credential
              organization workspace.
            motion:templates:read: Read and preview accessible templates.
            motion:templates:write: Create, edit, share, and archive prompt templates.
            motion:sessions:read: Read permitted chats, job status and saved exports.
            motion:sessions:write: >-
              Create and steer Motion projects using organization workspace
              credits.
            motion:assets:read: Find and read permitted media library assets.
            motion:brand-kits:read: Read permitted brand kits.
            motion:brand-kits:write: Create and edit brand kits within current app permissions.
            motion:social:read: Read authorized social accounts and posts.
            motion:social:write: >-
              Draft, submit, approve and cancel posts within current app
              permissions.

````

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