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

# Create a project export

> Export the selected compositions. Each gets a separate export in the requested format.



## OpenAPI

````yaml /openapi.json post /projects/{id}/exports
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}/exports:
    post:
      tags:
        - Exports
      summary: Export project compositions
      description: >-
        Export the selected compositions. Each gets a separate export in the
        requested format.
      operationId: CreateAProjectExport
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
                - composition_ids
                - format
              properties:
                composition_ids:
                  type: array
                  minItems: 1
                  maxItems: 32
                  uniqueItems: true
                  items:
                    type: string
                  description: >-
                    Copy composition IDs from Read a project. Each selection
                    gets a separate export.
                format:
                  type: string
                  enum:
                    - mp4
                    - png
                    - jpeg
                    - psd
                    - svg
                    - media
                    - premiere
                    - after-effects
                    - resolve
                    - final-cut
                  description: >-
                    Export format. Use image formats for images and video or
                    editor formats for videos.
            example:
              composition_ids:
                - 9d2f19e2-2366-46bd-8963-869c340f723a:film
              format: mp4
      responses:
        '202':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MotionCreateProjectExportResponse'
              example:
                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: 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:film
                    turn_id: e8c3af4c-4f37-46b7-8b0d-53b09a67d6cb
        '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:write
components:
  schemas:
    MotionCreateProjectExportResponse:
      type: object
      properties:
        exports:
          type: array
          items:
            type: object
            properties:
              generation_id:
                anyOf:
                  - type: string
                    format: uuid
                  - type: 'null'
                description: >-
                  Saved project version used as the source. Null when not
                  recorded.
              id:
                type: string
                description: >-
                  Stable export receipt UUID. Pass this ID as export_id to
                  get_project_export.
              project_id:
                type: string
                format: uuid
                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. Each new API export
                  contains one.
              turn_id:
                anyOf:
                  - type: string
                    format: uuid
                  - 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
                  - type: 'null'
                description: >-
                  User who requested this export. Null for deleted users or
                  unrecorded historical attribution.
              created_by_you:
                description: >-
                  Whether you requested this export. Null when the requester is
                  unknown.
                type:
                  - boolean
                  - 'null'
              created_at:
                type: string
                format: date-time
                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
                  - 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 with their format, status and download link.
      required:
        - exports
      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.