Request a download
Starts async generation of a downloadable file and returns a download_id to poll. Video is generated in the background; audio-only recordings complete immediately, so the response may already return status: completed with the file payload.
Downloads are private to the API client that created them, and URLs expire ~24 hours after generation—request a new one when it expires.
Only the owner, teammates who can view the recording, and people it was shared with at standard or admin level can download it. Limited-access shares get 403 Forbidden.
Authorizations
Include your API key in the X-Api-Key header of every request.
Path Parameters
The ID of the meeting recording to generate a download for.
123456789
Body
URL Fathom POSTs the completed download payload to when it is ready. If omitted, poll the status endpoint.
"https://example.com/destination"
Response
The download request was accepted. Poll the download status endpoint until it completes.
"dl_CJAj1YPuruCgWHaKgEBv6Mb1UsNj8x"
123456789
processing, completed, failed, expired "processing"
Present when a video recording's download is completed.
Present when an audio-only recording's download is completed.
Present when the download failed.
generation_failed, generation_timeout 
