Direct upload is available on every paid plan (Pro or higher). An admin can disable file uploads for your organization, and the mutation then returns
feature_disabled.Overview
TheconfirmUpload mutation confirms that a file has been successfully uploaded to the pre-signed URL and triggers the transcription process. This is the second step in the direct upload flow.
Upload Flow:
- Call createUploadUrl to get a pre-signed upload URL (and, with
upload_method: POST, its form fields) - Upload your file to
upload_urlwith the returnedupload_method: forPOST, a multipart form with everyupload_fieldsentry as a form field, then the file last, as the field namedfile; forPUT, the file as the request body (see Uploading the File) - Call
confirmUploadto confirm the upload and start transcription
Arguments
Response
Link to the meeting in Fireflies. It opens right away; the transcript appears there once processing finishes (usually a few minutes).
Usage Example
Complete Upload Flow Example
Here’s a complete example showing the entire upload flow:Error Codes
object_not_found (UploadSession)
object_not_found (UploadSession)
The upload session was not found or has expired. Upload sessions expire after 1 hour. You need to call
createUploadUrl again to get a new upload URL.object_not_found (Audio/Video)
object_not_found (Audio/Video)
The file was not found in storage. Make sure you have successfully uploaded the file to the signed URL before calling this mutation.
feature_disabled
feature_disabled
Your organization admin has disabled file uploads for transcription. Contact your admin to re-enable uploads. See feature_disabled.
invalid_arguments (file too large)
invalid_arguments (file too large)
The uploaded file is over the size limit for its type. With
upload_method: POST, storage already refuses such a file, so this applies to a PUT upload. Upload a smaller file to the same upload_url (with the same form fields, for a POST) before it expires, which replaces the stored file, then call confirmUpload again; or call createUploadUrl for a new upload URL.invalid_arguments (already confirmed)
invalid_arguments (already confirmed)
This upload was already confirmed, by an earlier call or one running right now. The file is transcribed once; open the meeting link in the message instead of uploading the file again.
Important Notes
- Upload sessions expire after 1 hour. If you don’t confirm within this time, you’ll need to start over with a new
createUploadUrlcall. - Make sure the file upload to the signed URL completes successfully before calling
confirmUpload. - The
meeting_idmust match the one returned fromcreateUploadUrl. - Only the user who created the upload session can confirm it.
- Confirm each upload once. Until the upload session expires (1 hour after
createUploadUrl), a second call is refused withinvalid_argumentsand the meeting link, so the file is never transcribed twice.
Audit Trail
A successful call records aMEETING_UPLOAD_CONFIRMED audit event for the meeting.
Additional Resources
Create Upload URL
Generate a pre-signed upload form or URL
Webhooks
Receive notifications when transcription completes
Transcript
Query the transcript after processing
Upload Audio (URL)
Alternative: Upload audio via public URL