Skip to main content
GET
Read an export

Authorizations

Authorization
string
header
required

A Motion API key. Access is limited to its stored organization, workspace, scopes and the creator’s current permissions.

Scopes

motion:sessions:read

Read permitted chats, job status and saved exports.

Path Parameters

id
string<uuid>
required
export_id
string
required

Response

Success

generation_id
string<uuid> | null
required

Saved project version used as the source. Null when not recorded.

id
string
required

Identifier of this resource. Use it when reading or updating the same resource.

project_id
string<uuid>
required

Motion project chat UUID returned by create_project or list_projects.

format
enum<string>
required

Requested export format. Availability depends on the project, permissions and normal plan.

Available options:
mp4,
png,
jpeg,
psd,
svg,
media,
premiere,
after-effects,
resolve,
final-cut
composition_ids
string[]
required

Compositions included in this export. Each new API export contains one.

turn_id
string<uuid> | null
required

Turn that saved the exported version, when recorded.

origin
enum<string> | null
required

Where this request originated. Null for historical exports without recorded provenance.

Available options:
app,
api
created_by
string<uuid> | null
required

User who requested this export. Null for deleted users or unrecorded historical attribution.

created_by_you
boolean | null
required

Whether you requested this export. Null when the requester is unknown.

created_at
string<date-time>
required

ISO 8601 timestamp when this resource was created.

status
enum<string>
required

Current state. The enum lists the values this resource can return.

Available options:
preparing,
completed,
failed
progress
number | null
required

Progress percentage for the current operation; null until progress is reported.

stage
enum<string> | null
required

Current export preparation stage, or null before preparation starts.

Available options:
waiting,
preparing,
rendering,
packaging,
completed,
failed
warnings
string[]
required

Export compatibility warnings; review these before handing off an editable project.

error
string | null
required

Actionable error text or sanitized failure code, or null when no error is present.

download_url
string<uri> | null
required

Signed download URL for this composition’s export package. Null until completed; read this export again to renew an expired link.

expires_at
string<date-time> | null
required

ISO 8601 expiration timestamp for this ticket or signed link. Request a fresh link after expiry.

filename
string

Human-readable file name including its extension.

size_bytes
number

Export package size in bytes when available.

content_type
string

Download MIME type, usually application/zip for a composition package.