Confirm Upload

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your_api_key" \
  -d '{
    "query": "mutation($input: ConfirmUploadInput!) { confirmUpload(input: $input) { success meeting_id message url } }",
    "variables": {
      "input": {
        "meeting_id": "abc123def456"
      }
    }
  }' \
  https://api.fireflies.ai/graphql

const axios = require('axios');

const url = 'https://api.fireflies.ai/graphql';
const headers = {
  'Content-Type': 'application/json',
  Authorization: 'Bearer your_api_key'
};

const input = {
  meeting_id: 'abc123def456'
};

const data = {
  query: `
    mutation($input: ConfirmUploadInput!) {
      confirmUpload(input: $input) {
        success
        meeting_id
        message
        url
      }
    }
  `,
  variables: { input }
};

axios
  .post(url, data, { headers })
  .then(result => {
    console.log(result.data);
  })
  .catch(e => {
    console.log(JSON.stringify(e));
  });

import requests

url = 'https://api.fireflies.ai/graphql'

headers = {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_api_key'
}

input_data = {
    "meeting_id": "abc123def456"
}

data = {
    'query': '''
        mutation($input: ConfirmUploadInput!) {
            confirmUpload(input: $input) {
                success
                meeting_id
                message
                url
            }
        }
    ''',
    'variables': {'input': input_data}
}

response = requests.post(url, headers=headers, json=data)

if response.status_code == 200:
    print(response.json())
else:
    print(response.text)

{
  "data": {
    "confirmUpload": {
      "success": true,
      "meeting_id": "abc123def456",
      "message": "Audio upload confirmed. Transcription processing has started.",
      "url": "https://app.fireflies.ai/view/abc123def456"
    }
  }
}

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your_api_key" \
  -d '{
    "query": "mutation($input: ConfirmUploadInput!) { confirmUpload(input: $input) { success meeting_id message url } }",
    "variables": {
      "input": {
        "meeting_id": "abc123def456"
      }
    }
  }' \
  https://api.fireflies.ai/graphql

const axios = require('axios');

const url = 'https://api.fireflies.ai/graphql';
const headers = {
  'Content-Type': 'application/json',
  Authorization: 'Bearer your_api_key'
};

const input = {
  meeting_id: 'abc123def456'
};

const data = {
  query: `
    mutation($input: ConfirmUploadInput!) {
      confirmUpload(input: $input) {
        success
        meeting_id
        message
        url
      }
    }
  `,
  variables: { input }
};

axios
  .post(url, data, { headers })
  .then(result => {
    console.log(result.data);
  })
  .catch(e => {
    console.log(JSON.stringify(e));
  });

import requests

url = 'https://api.fireflies.ai/graphql'

headers = {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_api_key'
}

input_data = {
    "meeting_id": "abc123def456"
}

data = {
    'query': '''
        mutation($input: ConfirmUploadInput!) {
            confirmUpload(input: $input) {
                success
                meeting_id
                message
                url
            }
        }
    ''',
    'variables': {'input': input_data}
}

response = requests.post(url, headers=headers, json=data)

if response.status_code == 200:
    print(response.json())
else:
    print(response.text)

{
  "data": {
    "confirmUpload": {
      "success": true,
      "meeting_id": "abc123def456",
      "message": "Audio upload confirmed. Transcription processing has started.",
      "url": "https://app.fireflies.ai/view/abc123def456"
    }
  }
}

This API is not generally available. Whitelisting is currently closed.

Overview

The confirmUpload 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
Upload your file directly to the URL using an HTTP PUT request
Call confirmUpload to confirm the upload and start transcription

Arguments

ConfirmUploadInput

required

Show child attributes

String

required

The meeting ID returned from the createUploadUrl mutation. This identifies which upload session to confirm.

Response

Boolean

Indicates whether the confirmation was successful and transcription has been queued.

String

The meeting ID for the confirmed upload.

String

A message describing the result of the confirmation.

String

Link to the meeting in Fireflies. It opens right away; the transcript appears there once processing finishes (usually a few minutes).

Usage Example

mutation confirmUpload($input: ConfirmUploadInput!) {
  confirmUpload(input: $input) {
    success
    meeting_id
    message
    url
  }
}

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your_api_key" \
  -d '{
    "query": "mutation($input: ConfirmUploadInput!) { confirmUpload(input: $input) { success meeting_id message url } }",
    "variables": {
      "input": {
        "meeting_id": "abc123def456"
      }
    }
  }' \
  https://api.fireflies.ai/graphql

const axios = require('axios');

const url = 'https://api.fireflies.ai/graphql';
const headers = {
  'Content-Type': 'application/json',
  Authorization: 'Bearer your_api_key'
};

const input = {
  meeting_id: 'abc123def456'
};

const data = {
  query: `
    mutation($input: ConfirmUploadInput!) {
      confirmUpload(input: $input) {
        success
        meeting_id
        message
        url
      }
    }
  `,
  variables: { input }
};

axios
  .post(url, data, { headers })
  .then(result => {
    console.log(result.data);
  })
  .catch(e => {
    console.log(JSON.stringify(e));
  });

import requests

url = 'https://api.fireflies.ai/graphql'

headers = {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_api_key'
}

input_data = {
    "meeting_id": "abc123def456"
}

data = {
    'query': '''
        mutation($input: ConfirmUploadInput!) {
            confirmUpload(input: $input) {
                success
                meeting_id
                message
                url
            }
        }
    ''',
    'variables': {'input': input_data}
}

response = requests.post(url, headers=headers, json=data)

if response.status_code == 200:
    print(response.json())
else:
    print(response.text)

{
  "data": {
    "confirmUpload": {
      "success": true,
      "meeting_id": "abc123def456",
      "message": "Audio upload confirmed. Transcription processing has started.",
      "url": "https://app.fireflies.ai/view/abc123def456"
    }
  }
}

Complete Upload Flow Example

Here’s a complete example showing the entire upload flow:

const axios = require('axios');
const fs = require('fs');

const API_URL = 'https://api.fireflies.ai/graphql';
const API_KEY = 'your_api_key';

async function uploadAudioFile(filePath, title) {
  const fileBuffer = fs.readFileSync(filePath);
  const fileSize = fileBuffer.length;
  
  // Step 1: Get the signed upload URL
  const createUrlResponse = await axios.post(API_URL, {
    query: `
      mutation($input: CreateUploadUrlInput!) {
        createUploadUrl(input: $input) {
          upload_url
          meeting_id
          expires_at
        }
      }
    `,
    variables: {
      input: {
        content_type: 'audio/mpeg',
        file_size: fileSize,
        title: title
      }
    }
  }, {
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${API_KEY}`
    }
  });
  
  const { upload_url, meeting_id } = createUrlResponse.data.data.createUploadUrl;
  console.log('Got upload URL for meeting:', meeting_id);
  
  // Step 2: Upload the file to the signed URL
  await axios.put(upload_url, fileBuffer, {
    headers: {
      'Content-Type': 'audio/mpeg'
    }
  });
  console.log('File uploaded successfully');
  
  // Step 3: Confirm the upload
  const confirmResponse = await axios.post(API_URL, {
    query: `
      mutation($input: ConfirmUploadInput!) {
        confirmUpload(input: $input) {
          success
          meeting_id
          message
          url
        }
      }
    `,
    variables: {
      input: {
        meeting_id: meeting_id
      }
    }
  }, {
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${API_KEY}`
    }
  });
  
  const { url } = confirmResponse.data.data.confirmUpload;
  console.log('Upload confirmed. The transcript will appear at:', url);
  return meeting_id;
}

// Usage
uploadAudioFile('./meeting-recording.mp3', 'Team Standup')
  .then(meetingId => console.log('Transcription started for:', meetingId))
  .catch(err => console.error('Upload failed:', err));

Error Codes

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)

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

Your organization admin has disabled file uploads for transcription. Contact your admin to re-enable uploads. See feature_disabled.

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.

service_unavailable

Fireflies could not tell whether processing started (for example, the request timed out). The message says so and links the meeting: check it before uploading again, since it may still be transcribed. The same upload cannot be confirmed again for up to an hour; if the meeting gets no transcript, upload the file again with a new createUploadUrl.

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 createUploadUrl call.
Make sure the file upload to the signed URL completes successfully before calling confirmUpload.
The meeting_id must match the one returned from createUploadUrl.
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 with invalid_arguments and the meeting link, so the file is never transcribed twice.

Audit Trail

A successful call records a MEETING_UPLOAD_CONFIRMED audit event for the meeting.

Additional Resources

Create Upload URL

Generate a pre-signed URL for uploads

Webhooks

Receive notifications when transcription completes

Transcript

Query the transcript after processing

Upload Audio (URL)

Alternative: Upload audio via public URL

Getting Started

Fundamentals

Examples

Integrations

AskFred

MCP

GraphQL API

Realtime API

Schema

Miscellaneous

Additional Info

Overview

Arguments

Response

Usage Example

Complete Upload Flow Example

Error Codes

Important Notes

Audit Trail

Additional Resources

Create Upload URL

Webhooks

Transcript

Upload Audio (URL)

​Overview

​Arguments

​Response

​Usage Example

​Complete Upload Flow Example

​Error Codes

​Important Notes

​Audit Trail

​Additional Resources

Create Upload URL

Webhooks

Transcript

Upload Audio (URL)

Overview

Arguments

Response

Usage Example

Complete Upload Flow Example

Error Codes

Important Notes

Audit Trail

Additional Resources