version: "1.0.0" name: export-timeline description: Export a Descript project's timeline for another editor like Premiere Pro, DaVinci Resolve, Final Cut Pro, or Pro Tools.

Export Timeline

When to use

• When the user wants to continue editing in another NLE or DAW (Premiere Pro, DaVinci Resolve, Final Cut Pro, Pro Tools, Logic, Audition, Reaper)
• When they ask for a timeline, XML, EDL, AAF, or interchange file

Instructions

1. Locate the project with search_drive (or list_projects if filtering/paginating the project list), then use get_project to retrieve its composition IDs.
2. If the project has more than one composition, confirm which one and pass its composition_id explicitly.
3. Call export_timeline with the project ID, composition ID, and a format (edl, sesx, fcp, premiere, davinci_resolve, or aaf). Media files are never bundled — only the timeline file itself.
4. export_timeline is asynchronous and returns a job_id. Wait for it by polling wait_for_job with wait_seconds: 20 until the job is terminal, surfacing progress.label/percent. A timeout (-32001) or a still_running wait status means it is still going — poll the same job_id again, never re-export.
5. Report the download_url from the completed job's result back to the user. It is time-limited (valid until download_url_expires_at), so tell the user to download promptly.