# Fireflies.ai

> 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.

Source: https://cotera.co/docs/reference/tools/individual-tools/fireflies

---

**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](https://app.fireflies.ai/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](https://docs.fireflies.ai/getting-started/introduction).

***

## 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:**

```json
{
  "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:**

```json
{
  "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:**

```json
{
  "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:**

```json
{
  "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:**

```json
{
  "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:**

```json
{
  "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:**

```json
{}
```

### 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:**

```json
{
  "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:**

```json
{
  "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:**

```json
{
  "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:**

```json
{
  "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:**

```json
{
  "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:**

```json
{}
```

***

## 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:**

```json
{}
```

***

## 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:**

```json
{
  "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:**

```json
{
  "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