> ## 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 a project

> Read project status, messages, saved compositions and exports.



## OpenAPI

````yaml /openapi.json get /projects/{id}
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:
  /projects/{id}:
    get:
      tags:
        - Projects
      summary: Read a project
      description: Read project status, messages, saved compositions and exports.
      operationId: ReadAProject
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 25
          description: Page size for both messages and generations.
        - name: cursor
          in: query
          schema:
            type: string
          description: next_cursor from the preceding generation page.
        - name: after_sequence
          in: query
          schema:
            type: integer
            minimum: 0
          description: Read messages after this sequence number.
        - name: include_explanations
          in: query
          schema:
            type: boolean
            default: false
          description: Include user-visible progress explanations.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MotionGetProjectResponse'
              example:
                id: 4f20dcdd-f63b-4898-97d6-2e05c0d37c78
                title: Product launch
                status: completed
                created_at: '2026-11-17T20:00:00Z'
                updated_at: '2026-11-17T20:00:00Z'
                chat_url: >-
                  https://motion.so/agent?chat=4f20dcdd-f63b-4898-97d6-2e05c0d37c78
                generations:
                  - id: 9d2f19e2-2366-46bd-8963-869c340f723a
                    created_at: '2026-11-17T20:00:00Z'
                    status: ready
                    turn_id: e8c3af4c-4f37-46b7-8b0d-53b09a67d6cb
                    compositions:
                      - id: 9d2f19e2-2366-46bd-8963-869c340f723a:film
                        kind: video
                        width: 1920
                        height: 1080
                        duration_seconds: 15
                      - id: 9d2f19e2-2366-46bd-8963-869c340f723a:thumbnail
                        kind: image
                        width: 640
                        height: 360
                        duration_seconds: null
                has_more: false
                next_cursor: null
                exports:
                  - generation_id: 9d2f19e2-2366-46bd-8963-869c340f723a
                    id: 46ed7444-a055-462b-9c17-0a2cdd5ca393
                    project_id: 4f20dcdd-f63b-4898-97d6-2e05c0d37c78
                    format: mp4
                    created_at: '2026-11-17T20:00:00Z'
                    status: completed
                    progress: 100
                    stage: completed
                    warnings: []
                    error: null
                    download_url: https://downloads.example.com/film-mp4.zip
                    expires_at: '2026-11-17T21:00:00Z'
                    filename: film-mp4.zip
                    origin: api
                    created_by: bfa220bc-731d-4d9a-a6bf-e7da483f52ca
                    content_type: application/zip
                    created_by_you: true
                    composition_ids:
                      - 9d2f19e2-2366-46bd-8963-869c340f723a:film
                    turn_id: e8c3af4c-4f37-46b7-8b0d-53b09a67d6cb
                  - generation_id: 9d2f19e2-2366-46bd-8963-869c340f723a
                    id: 5a4f249a-8c2b-471f-b9b0-ff8e3e5e1aa9
                    project_id: 4f20dcdd-f63b-4898-97d6-2e05c0d37c78
                    format: png
                    created_at: '2026-11-17T20:00:00Z'
                    status: preparing
                    progress: 0
                    stage: preparing
                    warnings: []
                    error: null
                    download_url: null
                    expires_at: null
                    origin: api
                    created_by: bfa220bc-731d-4d9a-a6bf-e7da483f52ca
                    created_by_you: true
                    composition_ids:
                      - 9d2f19e2-2366-46bd-8963-869c340f723a:thumbnail
                    turn_id: e8c3af4c-4f37-46b7-8b0d-53b09a67d6cb
                export_formats:
                  - mp4
                  - png
                exports_has_more: false
                exports_next_cursor: null
                connectors: null
                effort: standard
                messages:
                  - id: e8c3af4c-4f37-46b7-8b0d-53b09a67d6cb
                    role: user
                    content: Create a launch video and thumbnail.
                    sequence_num: 1
                    created_at: '2026-11-17T19:59:00Z'
                    turn_id: e8c3af4c-4f37-46b7-8b0d-53b09a67d6cb
                    effort: standard
                    template_ids: []
                    brand_kit_ids: []
                  - id: 852c42fa-d891-4483-9f54-9b35ce6e51ef
                    role: assistant
                    content: Created the video and thumbnail.
                    sequence_num: 2
                    created_at: '2026-11-17T20:00:00Z'
                    turn_id: e8c3af4c-4f37-46b7-8b0d-53b09a67d6cb
                    effort: standard
                    explanations:
                      - Matched the requested colors and layout.
                    explanations_omitted: false
                messages_has_more: false
                messages_next_after_sequence: null
        '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:sessions:read
components:
  schemas:
    MotionGetProjectResponse:
      type: object
      properties:
        id:
          type: string
          format: uuid
          pattern: >-
            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
          description: >-
            Motion project UUID. Use it to read, continue or export this
            project.
        title:
          type:
            - string
            - 'null'
          description: >-
            Project title displayed in Motion, or null before a title is
            assigned.
        status:
          type: string
          enum:
            - queued
            - running
            - completed
            - failed
            - cancelled
            - awaiting_user_input
            - awaiting_credits
          description: >-
            Project work status. Completed means the agent finished; exports may
            still be preparing.
        created_at:
          type: string
          format: date-time
          pattern: >-
            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
          description: Project creation time.
        updated_at:
          type: string
          format: date-time
          pattern: >-
            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
          description: Time the project record was last updated.
        chat_url:
          type: string
          format: uri
          description: >-
            Motion web chat URL where the user can inspect and continue this
            project.
        effort:
          type: string
          enum:
            - standard
            - extended
          description: >-
            Project effort fixed at creation. Follow-ups, steering and resumed
            turns keep this choice.
        connectors:
          anyOf:
            - type: array
              items:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                    pattern: >-
                      ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                    description: >-
                      Identifier of this resource. Use it when reading or
                      updating the same resource.
                  actions:
                    anyOf:
                      - type: array
                        items:
                          type: string
                          enum:
                            - repositories
                            - code
                            - issues
                            - history
                            - pages
                            - comments
                            - create_pages
                            - edit_pages
                            - add_comments
                            - designs
                            - code_connect
                            - edit_code_connect
                            - diagrams
                            - files
                            - downloads
                            - uploads
                            - folders
                            - deletes
                            - search
                            - posts
                            - publish
                            - engagement
                            - following
                            - prepare
                            - discard
                      - type: 'null'
                    description: >-
                      Allowed connector action IDs from permission_options. Null
                      uses the current allowed actions; an array narrows this
                      project’s access.
                required:
                  - id
                  - actions
                additionalProperties: false
            - type: 'null'
          description: >-
            Connections available to this project. null uses the default
            selection; [] disables connectors.
        export_formats:
          type: array
          items:
            type: string
            enum:
              - mp4
              - png
              - jpeg
              - media
              - premiere
              - after-effects
              - resolve
              - final-cut
              - psd
              - svg
          description: >-
            Current automatic export settings. Each turn uses these unless its
            message changes them. [] disables automatic exports.
          examples:
            - - mp4
              - png
        messages:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
                format: uuid
                pattern: >-
                  ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                description: >-
                  Message UUID returned for an accepted prompt or saved
                  assistant response.
              role:
                type: string
                enum:
                  - user
                  - assistant
                description: 'Who sent this message: user or assistant.'
              content:
                type: string
                description: >-
                  The message text shown in the conversation, with sensitive
                  internal content removed.
              sequence_num:
                type: integer
                minimum: 0
                maximum: 9007199254740991
                description: >-
                  Message position within this chat. Use next_after_sequence for
                  pagination.
              created_at:
                type: string
                format: date-time
                pattern: >-
                  ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
                description: ISO 8601 timestamp when this resource was created.
              turn_id:
                anyOf:
                  - type: string
                    format: uuid
                    pattern: >-
                      ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                  - type: 'null'
                description: >-
                  Starting user-message UUID shared by all messages and saved
                  generations from one turn. Steering retains this ID;
                  historical turns may have no recorded ID.
              effort:
                anyOf:
                  - type: string
                    enum:
                      - standard
                      - extended
                  - type: 'null'
                description: Effort used for this turn; null when unavailable.
              template_ids:
                description: Templates attached to this user message.
                type: array
                items:
                  type: string
              brand_kit_ids:
                description: Effective brand kits for this user message.
                type: array
                items:
                  type: string
                  format: uuid
                  pattern: >-
                    ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
              explanations:
                type: array
                items:
                  type: string
                description: User-visible progress explanations.
              explanations_omitted:
                type: boolean
                description: Some progress explanations are missing from this response.
            required:
              - id
              - role
              - content
              - sequence_num
              - created_at
              - turn_id
              - effort
            additionalProperties: false
          description: User and assistant messages in conversation order.
        messages_has_more:
          type: boolean
          description: More messages are available.
        messages_next_after_sequence:
          anyOf:
            - type: integer
              minimum: 0
              maximum: 9007199254740991
            - type: 'null'
          description: Pass as after_sequence to read the next message page.
        generations:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
                format: uuid
                pattern: >-
                  ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                description: Saved project version. Use this ID to create a template.
              turn_id:
                anyOf:
                  - type: string
                    format: uuid
                    pattern: >-
                      ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                  - type: 'null'
                description: >-
                  Matches messages.turn_id for the turn that saved this
                  generation. Null for historical versions without a recorded
                  turn.
              created_at:
                type: string
                format: date-time
                pattern: >-
                  ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
                description: Time this authored version was saved.
              status:
                type: string
                const: ready
                description: Saved editable version.
              compositions:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      description: Composition ID. Use it to request an export.
                    kind:
                      type: string
                      enum:
                        - video
                        - image
                      description: >-
                        Resource kind or authored output type as specified by
                        this response.
                    width:
                      anyOf:
                        - type: integer
                          exclusiveMinimum: 0
                          maximum: 9007199254740991
                        - type: 'null'
                      description: Template canvas width in pixels.
                    height:
                      anyOf:
                        - type: integer
                          exclusiveMinimum: 0
                          maximum: 9007199254740991
                        - type: 'null'
                      description: Template canvas height in pixels.
                    duration_seconds:
                      anyOf:
                        - type: number
                          minimum: 0
                        - type: 'null'
                      description: Template or media usage duration in seconds.
                  required:
                    - id
                    - kind
                    - width
                    - height
                    - duration_seconds
                  additionalProperties: false
                description: Editable compositions in this saved version.
            required:
              - id
              - turn_id
              - created_at
              - status
              - compositions
            additionalProperties: false
          description: Saved project versions, each containing one or more compositions.
        exports:
          maxItems: 25
          type: array
          items:
            type: object
            properties:
              generation_id:
                anyOf:
                  - type: string
                    format: uuid
                    pattern: >-
                      ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                  - type: 'null'
                description: >-
                  Saved source generation UUID, or null when this export has no
                  recorded saved-generation link.
              id:
                type: string
                description: >-
                  Stable export receipt UUID. Pass this ID as export_id to
                  get_project_export.
              project_id:
                type: string
                format: uuid
                pattern: >-
                  ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                description: >-
                  Motion project chat UUID returned by create_project or
                  list_projects.
              format:
                type: string
                enum:
                  - mp4
                  - png
                  - jpeg
                  - psd
                  - svg
                  - media
                  - premiere
                  - after-effects
                  - resolve
                  - final-cut
                description: >-
                  Requested export format. Availability depends on the project,
                  permissions and normal plan.
              composition_ids:
                type: array
                items:
                  type: string
                description: >-
                  Compositions included in this export. New API exports contain
                  one; older app bundles may contain several.
              turn_id:
                anyOf:
                  - type: string
                    format: uuid
                    pattern: >-
                      ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                  - type: 'null'
                description: Turn that saved the exported version, when recorded.
              origin:
                anyOf:
                  - type: string
                    enum:
                      - app
                      - api
                  - type: 'null'
                description: >-
                  Where this request originated. Null for historical exports
                  without recorded provenance.
              created_by:
                anyOf:
                  - type: string
                    format: uuid
                    pattern: >-
                      ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                  - type: 'null'
                description: >-
                  User who requested this export. Null for deleted users or
                  unrecorded historical attribution.
              created_by_you:
                description: >-
                  True when the user behind this credential requested the
                  export; false for another requester; null when historical
                  attribution is unavailable.
                type:
                  - boolean
                  - 'null'
              created_at:
                type: string
                format: date-time
                pattern: >-
                  ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
                description: ISO 8601 timestamp when this resource was created.
              status:
                type: string
                enum:
                  - preparing
                  - completed
                  - failed
                description: >-
                  Current state. The enum lists the values this resource can
                  return.
              progress:
                type:
                  - number
                  - 'null'
                description: >-
                  Progress percentage for the current operation; null until
                  progress is reported.
              stage:
                anyOf:
                  - type: string
                    enum:
                      - waiting
                      - preparing
                      - rendering
                      - packaging
                      - completed
                      - failed
                  - type: 'null'
                description: >-
                  Current export preparation stage, or null before preparation
                  starts.
              warnings:
                type: array
                items:
                  type: string
                description: >-
                  Export compatibility warnings; review these before handing off
                  an editable project.
              error:
                type:
                  - string
                  - 'null'
                description: >-
                  Actionable error text or sanitized failure code, or null when
                  no error is present.
              filename:
                type: string
                description: Human-readable file name including its extension.
              size_bytes:
                description: Export package size in bytes when available.
                type: number
              content_type:
                description: >-
                  Download MIME type, usually application/zip for a composition
                  package.
                type: string
              download_url:
                anyOf:
                  - type: string
                    format: uri
                  - type: 'null'
                description: >-
                  Signed download URL for this composition’s export package.
                  Null until completed; read this export again to renew an
                  expired link.
              expires_at:
                anyOf:
                  - type: string
                    format: date-time
                    pattern: >-
                      ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
                  - type: 'null'
                description: >-
                  ISO 8601 expiration timestamp for this ticket or signed link.
                  Request a fresh link after expiry.
            required:
              - generation_id
              - id
              - project_id
              - format
              - composition_ids
              - turn_id
              - origin
              - created_by
              - created_by_you
              - created_at
              - status
              - progress
              - stage
              - warnings
              - error
              - download_url
              - expires_at
            additionalProperties: false
          description: >-
            Exports from the API and app. Each includes its format, status and
            download when ready.
        exports_has_more:
          type: boolean
          description: More exports are available.
        exports_next_cursor:
          description: Pass as cursor to list_project_exports to read more.
          type:
            - string
            - 'null'
        has_more:
          type: boolean
          description: True when another page is available.
        next_cursor:
          type:
            - string
            - 'null'
          description: >-
            Opaque cursor for the next page, or null at the end. Pass it
            unchanged as cursor.
      required:
        - id
        - title
        - status
        - created_at
        - updated_at
        - chat_url
        - effort
        - connectors
        - export_formats
        - messages
        - messages_has_more
        - messages_next_after_sequence
        - generations
        - exports
        - exports_has_more
        - exports_next_cursor
        - has_more
        - next_cursor
      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.