cotera
Logo

Fireflies.ai

Authentication Type: API Key Description: Access Fireflies.ai meeting transcription and AI platform. List, search, and manage transcripts, add bots to live meetings, upload audio for transcription, manage soundbites, and interact with AskFred AI assistant.

Authentication

To authenticate, you'll need a Fireflies.ai API key:

  1. Log in to your Fireflies.ai account
  2. Go to Fireflies Integrations and navigate to the API section
  3. Generate a new API key

You'll need to provide:

  • apiKey: Your Fireflies.ai API key

For more information, visit the Fireflies API documentation.

Transcripts

Operations for managing meeting transcripts.

List Transcripts

List transcripts with optional filters for keyword search, date range, and participants.

Operation Type: Query (Read)

Parameters:

  • keyword string (nullable): Search keyword
  • fromDate string (nullable): Start date (YYYY-MM-DD)
  • toDate string (nullable): End date (YYYY-MM-DD)
  • limit number (nullable): Max results (max 50)
  • skip number (nullable): Number of results to skip
  • host_email string (nullable): Filter by host email
  • mine boolean (nullable): Only show my transcripts
  • organizers string[] (nullable): Filter by organizer emails
  • participants string[] (nullable): Filter by participant emails

Returns:

  • transcripts array of objects: List of transcripts
    • id string: Transcript ID
    • title string: Meeting title
    • date string: Meeting date
    • duration number: Duration in minutes
    • transcript_url string: URL to view the transcript
    • organizer_email string: Organizer's email
    • participants array of objects: Participant list
      • name string: Participant name
      • email string: Participant email

Example Usage:

{
  "keyword": "product roadmap",
  "fromDate": "2026-01-01",
  "toDate": "2026-02-20",
  "limit": 10,
  "mine": true
}

Get Transcript

Get a full transcript with sentences, speakers, and AI-generated summary.

Operation Type: Query (Read)

Parameters:

  • id string (required): Transcript ID

Returns:

  • id string: Transcript ID
  • title string: Meeting title
  • date string: Meeting date
  • duration number: Duration in minutes
  • transcript_url string: URL to view the transcript
  • audio_url string: URL to the audio recording
  • organizer_email string: Organizer's email
  • participants array of objects: Participant list
    • name string: Participant name
    • email string: Participant email
  • sentences array of objects: Transcript sentences
    • text string: Sentence text
    • speaker_name string: Speaker name
    • start_time number: Start time in seconds
    • end_time number: End time in seconds
  • summary object: AI-generated summary
    • keywords string[]: Key topics
    • action_items string[]: Action items
    • overview string: Meeting overview
    • short_summary string: Brief summary

Example Usage:

{
  "id": "abc123def456"
}

Delete Transcript

Delete a transcript by ID.

Operation Type: Mutation (Write)

Parameters:

  • id string (required): Transcript ID to delete

Returns:

  • id string: Deleted transcript ID
  • title string: Deleted transcript title

Example Usage:

{
  "id": "abc123def456"
}

Update Title

Update the title of a meeting transcript.

Operation Type: Mutation (Write)

Parameters:

  • id string (required): Transcript ID
  • title string (required): New title

Returns:

  • title string: Updated title

Example Usage:

{
  "id": "abc123def456",
  "title": "Q1 Product Roadmap Review - Feb 2026"
}

Update Privacy

Update privacy settings of a transcript.

Operation Type: Mutation (Write)

Parameters:

  • id string (required): Transcript ID
  • privacy string (required): Privacy setting: link, owner, participants, teammatesandparticipants, or teammates

Returns:

  • id string: Transcript ID
  • title string: Transcript title
  • privacy string: Updated privacy setting

Example Usage:

{
  "id": "abc123def456",
  "privacy": "teammates"
}

Meetings

Operations for managing live meetings.

Add Bot to Meeting

Add a Fireflies bot to a live meeting to record and transcribe.

Operation Type: Mutation (Write)

Parameters:

  • meeting_link string (required): Meeting link (Zoom, Google Meet, etc.)
  • title string (nullable): Meeting title
  • duration number (nullable): Expected duration in minutes
  • language string (nullable): Language code (e.g., en, es, fr)

Returns:

  • success boolean: Whether the bot was successfully added

Example Usage:

{
  "meeting_link": "https://meet.google.com/abc-defg-hij",
  "title": "Weekly Standup",
  "duration": 30,
  "language": "en"
}

List Active Meetings

List active/ongoing meetings.

Operation Type: Query (Read)

Parameters: None

Returns:

  • meetings array of objects: Active meetings
    • id string: Meeting ID
    • title string: Meeting title
    • organizer_email string: Organizer's email
    • meeting_link string: Meeting link
    • start_time string: Start time
    • state string: Current state

Example Usage:

{}

Update Meeting State

Pause or resume a meeting recording.

Operation Type: Mutation (Write)

Parameters:

  • id string (required): Meeting ID
  • action string (required): Action to perform: pause or resume

Returns:

  • success boolean: Whether the action was successful
  • action string: The action performed

Example Usage:

{
  "id": "meeting-abc123",
  "action": "pause"
}

Audio Upload

Operations for uploading audio files for transcription.

Upload Audio

Upload an audio file URL for transcription.

Operation Type: Mutation (Write)

Parameters:

  • url string (required): URL of the audio file to upload
  • title string (nullable): Title for the transcript
  • webhook string (nullable): Webhook URL for completion notification

Returns:

  • success boolean: Whether the upload was successful
  • title string: Transcript title
  • message string: Status message

Example Usage:

{
  "url": "https://storage.example.com/recordings/meeting-2026-02-20.mp3",
  "title": "Customer Interview - Feb 20",
  "webhook": null
}

Soundbites

Operations for managing soundbites (clips from transcripts).

List Soundbites

List soundbites with optional filters.

Operation Type: Query (Read)

Parameters:

  • mine boolean (nullable, default: true): Return only my soundbites
  • transcript_id string (nullable): Filter by transcript ID
  • my_team boolean (nullable): Return team soundbites
  • limit number (nullable): Max results to return
  • skip number (nullable): Number of results to skip

Returns:

  • bites array of objects: List of soundbites
    • id string: Soundbite ID
    • transcript_id string: Source transcript ID
    • name string: Soundbite name
    • status string: Processing status
    • summary string: Soundbite summary
    • start_time number: Start time in seconds
    • end_time number: End time in seconds
    • created_at string: Created timestamp

Example Usage:

{
  "mine": true,
  "transcript_id": "abc123def456",
  "limit": 20
}

Create Soundbite

Create a soundbite from a transcript segment.

Operation Type: Mutation (Write)

Parameters:

  • transcript_id string (required): Transcript ID
  • name string (required): Soundbite name
  • start_time number (required): Start time in seconds
  • end_time number (required): End time in seconds

Returns:

  • id string: Created soundbite ID

Example Usage:

{
  "transcript_id": "abc123def456",
  "name": "Key product decision",
  "start_time": 120.5,
  "end_time": 180.0
}

Users

Operations for managing Fireflies users.

Get User

Get user details by ID.

Operation Type: Query (Read)

Parameters:

  • id string (required): User ID

Returns:

  • user_id string: User ID
  • email string: User email
  • name string: User name
  • num_transcripts number: Number of transcripts
  • recent_meeting string: Most recent meeting timestamp
  • is_admin boolean: Whether the user is an admin
  • integrations object: Connected integrations

Example Usage:

{
  "id": "user-abc123"
}

List Users

List all users in the workspace.

Operation Type: Query (Read)

Parameters: None

Returns:

  • users array of objects: List of users
    • user_id string: User ID
    • email string: User email
    • name string: User name
    • num_transcripts number: Number of transcripts
    • is_admin boolean: Whether the user is an admin

Example Usage:

{}

Channels

Operations for managing Fireflies channels.

List Channels

List all channels in the workspace.

Operation Type: Query (Read)

Parameters: None

Returns:

  • channels array of objects: List of channels
    • id string: Channel ID
    • title string: Channel title
    • is_private boolean: Whether the channel is private
    • created_at string: Created timestamp

Example Usage:

{}

AskFred AI

Operations for interacting with the AskFred AI assistant, which can answer questions about your meeting transcripts.

Create AskFred Thread

Start a new AskFred conversation thread about a transcript.

Operation Type: Mutation (Write)

Parameters:

  • transcript_id string (required): Transcript ID
  • query string (required): Question to ask about the transcript

Returns:

  • thread_id string: Thread ID for follow-up questions
  • answer string: AskFred's answer

Example Usage:

{
  "transcript_id": "abc123def456",
  "query": "What were the main action items from this meeting?"
}

Continue AskFred Thread

Continue an existing AskFred conversation thread with a follow-up question.

Operation Type: Mutation (Write)

Parameters:

  • thread_id string (required): Thread ID from a previous AskFred interaction
  • query string (required): Follow-up question

Returns:

  • answer string: AskFred's answer

Example Usage:

{
  "thread_id": "thread-abc123",
  "query": "Who was responsible for each action item?"
}

Common Use Cases

Meeting Intelligence:

  • List and search transcripts to find discussions on specific topics
  • Get full transcripts with AI-generated summaries, action items, and keywords
  • Create soundbites to highlight and share key moments from meetings
  • Use AskFred to query meeting content without reading entire transcripts

Meeting Automation:

  • Add Fireflies bot to live meetings for automatic recording and transcription
  • Upload audio files from external sources for transcription
  • Pause and resume meeting recordings during sensitive discussions
  • Set up webhooks for notifications when transcriptions complete

Team Collaboration:

  • Share transcripts and soundbites across team channels
  • Search across all team meetings to find decisions and commitments
  • Track meeting frequency and participation through user stats
  • Organize meetings into channels for better discoverability