Skip to main content

Overview

The createLiveSoundbite mutation allows you to create a soundbite during a live meeting through the API. The soundbite is created using natural language processing via Fred, Fireflies’ AI assistant.
Rate Limit: This mutation is rate-limited to 10 requests per hour across all user tiers. If you exceed this limit, you will receive a too_many_requests error with a retryAfter timestamp indicating when you can make requests again.AI Credits: This mutation requires AI credits to be available on the user’s account.

Arguments

input
CreateLiveSoundbiteInput!
required
Input object containing the meeting ID and prompt for the soundbite. See CreateLiveSoundbiteInput for details.

Response

success
Boolean!
Whether the soundbite was created successfully

Usage Example

To create a live soundbite, provide the meeting ID and a natural language prompt:
mutation CreateLiveSoundbite($input: CreateLiveSoundbiteInput!) {
  createLiveSoundbite(input: $input) {
    success
  }
}
curl -X POST https://api.fireflies.ai/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your_api_key" \
  -d '{
    "query": "mutation CreateLiveSoundbite($input: CreateLiveSoundbiteInput!) { createLiveSoundbite(input: $input) { success } }",
    "variables": {
      "input": {
        "meeting_id": "your_meeting_id",
        "prompt": "Create a soundbite from the last 2 minutes"
      }
    }
  }'
{
  "data": {
    "createLiveSoundbite": {
      "success": true
    }
  }
}

Error Codes

List of possible error codes that may be returned by the createLiveSoundbite mutation. Full list of error codes can be found here.

The user account has been cancelled. Please contact support if you encounter this error.

The meeting with the specified ID was not found or you do not have access to it.

You do not have permission to create soundbites for this meeting. Only the meeting organizer or team admin can create live soundbites.

Your account does not have sufficient AI credits to perform this operation. Please upgrade your plan or purchase additional credits.

You have exceeded the rate limit of 10 requests per hour. Wait until the time specified in the retryAfter field before making additional requests.

Additional Resources