Fireflies AI

https://docs.fireflies.ai/
Admin
Fireflies AI offers a public GraphQL API for efficient and flexible access to meeting data, enabling...
Tokens:271,144
Snippets:2,429
Trust Score:10
Update:2 weeks ago
Show doc for...
Tokens:
Raw
### CreateBite Response Example

Source: https://docs.fireflies.ai/graphql-api/mutation/create-bite

Example response from the createBite mutation, showing the returned fields: name and status. The status is "pending" in this example.

```json
{
  "data": {
    "createBite": {
      "name": "bite-name",
      "status": "pending",
    }
  }
}

```

--------------------------------

### Example response for setUserRole

Source: https://docs.fireflies.ai/graphql-api/mutation/set-user-role

Example response from the setUserRole mutation. Shows the returned user name and is_admin flag.

```json
{
  "data": {
    "setUserRole": {
      "name": "Justin Fly",
      "is_admin": "true",
    }
  }
}

```

--------------------------------

### uploadAudio response example

Source: https://docs.fireflies.ai/graphql-api/mutation/upload-audio

Example response from the uploadAudio mutation. Shows success true, the uploaded title, and a message indicating the audio is queued for processing.

```json
{
  "data": {
    "uploadAudio": {
      "success": true,
      "title": "title of the file",
      "message": "Uploaded audio has been queued for processing."
    }
  }
}
```

--------------------------------

### CreateLiveSoundbite API Request Examples (curl, JavaScript, Python, Java)

Source: https://docs.fireflies.ai/llms-full.txt

HTTP request examples for creating a live soundbite using the Fireflies GraphQL API. Each example sends a mutation with the meeting ID and prompt, and prints the response. Replace 'your_api_key' with a valid API key.

```bash
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"
      }
    }
  }'
```

```javascript
const axios = require('axios');

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

const data = {
  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'
    }
  }
};

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

```python
import requests

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

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

data = {
    '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'
        }
    }
}

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

if response.status_code == 200:
    print(response.json()['data'])
else:
    print(response.text)
```

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpRequest.BodyPublishers;

public class ApiRequest {
    public static void main(String[] args) {
        HttpClient client = HttpClient.newHttpClient();
        String jsonRequest = "{\"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\"}}}";
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.fireflies.ai/graphql"))
            .header("Content-Type", "application/json")
            .header("Authorization", "Bearer your_api_key")
            .POST(BodyPublishers.ofString(jsonRequest))
            .build();

        client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
            .thenApply(HttpResponse::body)
            .thenAccept(System.out::println)
            .join();
    }
}
```

--------------------------------

### GetAIAppsOutputs Response Example

Source: https://docs.fireflies.ai/graphql-api/query/apps

Example response from the GetAIAppsOutputs query, showing the apps array with transcript_id, user_id, app_id, and title fields.

```json
{
  "data": {
    "apps": [
		{
			"transcript_id": "transcript-id",
			"user_id": "user-id",
			"app_id": "app-id",
			"title": "Weekly sync"
		}
	]
  }
}

```

--------------------------------

### UpdateMeetingState response example

Source: https://docs.fireflies.ai/graphql-api/mutation/update-meeting-state

Example response from the UpdateMeetingState mutation when the action is pause_recording. Shows success true and the action echoed back.

```json
{
  "data": {
    "updateMeetingState": {
      "success": true,
      "action": "pause_recording"
    }
  }
}

```

--------------------------------

### Complete Upload Flow Example

Source: https://docs.fireflies.ai/graphql-api/mutation/confirm-upload

This snippet provides a complete JavaScript example of the direct upload flow, including creating an upload URL, uploading the file, and confirming the upload.

```APIDOC
## Complete Upload Flow Example

### Description
A complete example showing the entire upload flow: createUploadUrl, file upload, and confirmUpload.

### Code
```javascript
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
        }
      }
    `,
    variables: {
      input: {
        meeting_id: meeting_id
      }
    }
  }, {
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${API_KEY}`
    }
  });
  
  console.log('Upload confirmed:', confirmResponse.data.data.confirmUpload);
  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));
```
```

--------------------------------

### Example response for apps query

Source: https://docs.fireflies.ai/llms-full.txt

Example response from the apps query, showing the structure of the returned data with transcript_id, user_id, app_id, and title fields.

```json
{
  "data": {
    "apps": [
		{
			"transcript_id": "transcript-id",
			"user_id": "user-id",
			"app_id": "app-id",
			"title": "Weekly sync"
		}
	]
  }
}
```

--------------------------------

### ShareMeeting Python requests example

Source: https://docs.fireflies.ai/llms-full.txt

Python example using the requests library to call the ShareMeeting mutation. Requires the requests package and an API key. The response is printed as JSON.

```python
import requests

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

data = {
  'query': '''
    mutation($input: ShareMeetingInput!) {
      shareMeeting(input: $input) {
        success
        message
      }
    }
  ''',
  'variables': {
    'input': {
      'meeting_id': 'your_meeting_id',
      'emails': ['user@example.com'],
      'expiry_days': 7
    }
  }
}

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

--------------------------------

### createUploadUrl Response Example

Source: https://docs.fireflies.ai/graphql-api/mutation/create-upload-url

Example response from the createUploadUrl mutation. It contains the signed upload_url, the meeting_id, and the expiration timestamp. Use the upload_url to upload the file.

```json
{
  "data": {
    "createUploadUrl": {
      "upload_url": "https://storage.googleapis.com/...",
      "meeting_id": "abc123def456",
      "expires_at": "2024-01-15T12:00:00.000Z"
    }
  }
}
```

--------------------------------

### Example response for contacts query

Source: https://docs.fireflies.ai/llms-full.txt

Example response from the contacts query, showing a list of contacts with email, name, picture, and last meeting date.

```json
{
  "data": {
    "contacts": [
      {
        "email": "john.doe@example.com",
        "name": "John Doe",
        "picture": "https://example.com/photo.jpg",
        "last_meeting_date": "2024-12-05"
      },
      {
        "email": "jane.smith@example.com",
        "name": "Jane Smith",
        "picture": null,
        "last_meeting_date": "2024-11-28"
      }
    ]
  }
}
```

--------------------------------

### Example response for askfred_threads query

Source: https://docs.fireflies.ai/graphql-api/query/askfred-threads

Example response from the askfred_threads query. Shows two threads with their fields; transcript_id can be null when no transcript is linked.

```json
{
  "data": {
    "askfred_threads": [
      {
        "id": "thread_abc123",
        "title": "What were the action items from the Q4 planning meeting?",
        "transcript_id": "transcript_xyz789",
        "user_id": "user_123",
        "created_at": "2024-03-15T10:30:00Z"
      },
      {
        "id": "thread_def456",
        "title": "Summary of customer feedback discussions",
        "transcript_id": null,
        "user_id": "user_123",
        "created_at": "2024-03-14T14:20:00Z"
      }
    ]
  }
}

```

--------------------------------

### Example Response for createBite

Source: https://docs.fireflies.ai/graphql-api/mutation/create-bite

Example response for the createBite mutation, showing a pending status and a name field. Note: The response is illustrative; actual fields may vary.

```json
{
  "data": {
    "createBite": {
      "name": "bite-name",
      "status": "pending",
    }
  }
}
```

--------------------------------

### Response example for updateMeetingState

Source: https://docs.fireflies.ai/llms-full.txt

Example response from the updateMeetingState mutation. The success field indicates whether the action was executed successfully, and the action field echoes the requested action.

```json
{
  "data": {
    "updateMeetingState": {
      "success": true,
      "action": "pause_recording"
    }
  }
}
```

--------------------------------

### Example Response for askfred_thread Query

Source: https://docs.fireflies.ai/graphql-api/query/askfred-thread

Example response from the askfred_thread query, showing thread details and two messages with answers and suggested queries. The status field indicates completion.

```json
{
  "data": {
    "askfred_thread": {
      "id": "thread_abc123",
      "title": "What were the action items from the Q4 planning meeting?",
      "transcript_id": "transcript_xyz789",
      "user_id": "user_123",
      "created_at": "2024-03-15T10:30:00Z",
      "messages": [
        {
          "id": "msg_001",
          "query": "What were the action items from the Q4 planning meeting?",
          "answer": "Based on the Q4 planning meeting, here are the key action items:\n\n1. **Product Development** - Sarah to finalize the feature roadmap by March 20th\n2. **Marketing Campaign** - John to prepare Q4 marketing strategy presentation by March 25th\n3. **Budget Review** - Finance team to provide updated budget allocations by March 18th\n4. **Customer Success** - Emma to compile customer feedback report by end of week",
          "suggested_queries": [
            "Who is responsible for the product roadmap?",
            "What is the timeline for the marketing strategy?",
            "What were the budget concerns discussed?"
          ],
          "status": "completed",
          "created_at": "2024-03-15T10:30:00Z"
        },
        {
          "id": "msg_002",
          "query": "What were the budget concerns discussed?",
          "answer": "The main budget concerns discussed in the meeting were:\n\n1. **Resource Allocation** - Need to balance investment between product development and marketing\n2. **Headcount** - Discussion about hiring 3 new engineers vs 2 engineers and 1 marketing specialist\n3. **Tool Costs** - Review of current software subscriptions to identify cost-saving opportunities\n4. **Travel Budget** - Proposed 20% reduction in Q4 travel budget due to increased virtual meeting effectiveness",
          "suggested_queries": [
            "What was the final decision on headcount?",
            "Which software subscriptions were identified for review?",
            "How much is the current travel budget?"
          ],
          "status": "completed",
          "created_at": "2024-03-15T10:32:00Z"
        }
      ]
    }
  }
}

```

--------------------------------

### Basic Authentication Example

Source: https://docs.fireflies.ai/schema/input/download-auth-input

Configures DownloadAuthInput with type basic_auth and basic credentials. The basic field is required when type is basic_auth and must not be provided for other types.

```json
{
  type: basic_auth
  basic: {
    username: "your-username"
    password: "your-password"
  }
}
```

--------------------------------

### Query ActiveMeetings (Getting All States)

Source: https://docs.fireflies.ai/schema/enum/meeting-state

Example of querying all active meetings without a state filter, returning both active and paused meetings.

```APIDOC
## Query ActiveMeetings (Getting All States)

### Description
Query to retrieve all active meetings without a state filter, returning both active and paused meetings.

### Method
query

### Endpoint
active_meetings

### Parameters
No parameters required.

### Request Example
```graphql
query ActiveMeetings {
  active_meetings {
    id
    title
    state
  }
}
```

### Response
#### Success Response
- **id** (ID) - The meeting ID.
- **title** (String) - The meeting title.
- **state** (MeetingState) - The current state of the meeting.
```

--------------------------------

### Create Live Soundbite with Java (HttpClient)

Source: https://docs.fireflies.ai/graphql-api/mutation/create-live-soundbite

Java 11+ example using HttpClient to send the CreateLiveSoundbite mutation. Prints the response body asynchronously.

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpRequest.BodyPublishers;

public class ApiRequest {
    public static void main(String[] args) {
        HttpClient client = HttpClient.newHttpClient();
        String jsonRequest = "{\"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\"}}}";
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.fireflies.ai/graphql"))
            .header("Content-Type", "application/json")
            .header("Authorization", "Bearer your_api_key")
            .POST(BodyPublishers.ofString(jsonRequest))
            .build();

        client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
            .thenApply(HttpResponse::body)
            .thenAccept(System.out::println)
            .join();
    }
}

```

--------------------------------

### fireflies_get_analytics parameters

Source: https://docs.fireflies.ai/mcp-tools/overview

Example parameters for the fireflies_get_analytics tool. Filters analytics to meetings between the specified start and end times in ISO 8601 format.

```json
{
  "startTime": "2024-01-01T00:00:00.000Z",
  "endTime": "2024-12-31T23:59:59.999Z"
}
```

--------------------------------

### Create soundbite with fireflies_create_soundbite

Source: https://docs.fireflies.ai/mcp-tools/overview

Creates a soundbite from a meeting transcript. Requires write access to the meeting. The example specifies a transcript ID, start and end times, and a name.

```json
{
  "transcriptId": "meeting-id-12345",
  "startTime": 120,
  "endTime": 180,
  "name": "Key product decision"
}
```

--------------------------------

### No Authentication (Default) Example

Source: https://docs.fireflies.ai/schema/input/download-auth-input

Sets DownloadAuthInput to type none for publicly accessible media files. When type is none, neither bearer nor basic should be provided.

```json
{
  type: none
}
```

--------------------------------

### Response for users query

Source: https://docs.fireflies.ai/llms-full.txt

Example response for the users query, showing a list of users with their names and empty integrations arrays. This is the expected output when the query succeeds.

```json
{
  "data": {
    "users": [
      {
        "name": "Justin Fly",
        "integrations": []
      },
      {
        "name": "Peter Fire",
        "integrations": []
      }
    ]
  }
}
```

--------------------------------

### Delete Transcript - JavaScript (axios)

Source: https://docs.fireflies.ai/graphql-api/mutation/delete-transcript

Uses Node.js with axios to send the deleteTranscript mutation. The example builds a POST request with the GraphQL query and variables, then logs the response data or the error. Requires axios installed and an API key.

```javascript
const axios = require('axios');

const url = 'https://api.fireflies.ai/graphql';
const headers = {
  'Content-Type': 'application/json',
  Authorization: 'Bearer your_api_key'
};
const data = {
  query: `
      mutation($transcriptId: String!) {
        deleteTranscript(id: $transcriptId) {
          title
          date
          duration
          organizer_email
        }
      }
    `,
  variables: { transcriptId: 'transcript_id' }
};

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

--------------------------------

### Query transcript title and ID via Fireflies API (curl, JavaScript, Python, Java)

Source: https://docs.fireflies.ai/llms-full.txt

HTTP request examples to query the Fireflies GraphQL API for a transcript's title and ID. Replace 'your_api_key' and 'your_transcript_id' with actual values. The JavaScript example uses axios, the Python example uses requests, and the Java example uses java.net.http.

```bash
curl -X POST \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer your_api_key" \
	--data '{ "query": "query Transcript($transcriptId: String!) { transcript(id: $transcriptId) { title id } }", "variables": { "transcriptId": "your_transcript_id" } }' \
	https://api.fireflies.ai/graphql
```

```javascript
const axios = require('axios');

const url = 'https://api.fireflies.ai/graphql';
const headers = {
  'Content-Type': 'application/json',
  Authorization: 'Bearer your_api_key'
};
const data = {
  query: 'query Transcript($transcriptId: String!) { transcript(id: $transcriptId) { title id } }',
  variables: { transcriptId: 'your_transcript_id' }
};

axios
  .post(url, data, { headers: headers })
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.error('Error:', error);
  });
```

```python
import requests

url = 'https://api.fireflies.ai/graphql'
headers = {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_api_key'
}
data = '{"query": "query Transcript($transcriptId: String!) { transcript(id: $transcriptId) { title id } }", "variables": {"transcriptId": "your_transcript_id"}}'

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

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpRequest.BodyPublishers;

public class ApiRequest {
    public static void main(String[] args) {
        HttpClient client = HttpClient.newHttpClient();
        String jsonRequest = "{\"query\": \"query Transcript($transcriptId: String!) { transcript(id: $transcriptId) { title id } }\", \"variables\": {\"transcriptId\": \"your_transcript_id\"}}";
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.fireflies.ai/graphql"))
            .header("Content-Type", "application/json")
            .header("Authorization", "Bearer your_api_key")
            .POST(BodyPublishers.ofString(jsonRequest))
            .build();

        client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
            .thenApply(HttpResponse::body)
            .thenAccept(System.out::println)
            .join();
    }
}
```

--------------------------------

### Create Bite with Java (HttpClient)

Source: https://docs.fireflies.ai/graphql-api/mutation/create-bite

Java HttpClient example to create a bite. Sends an asynchronous POST request and prints the response body.

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpRequest.BodyPublishers;

public class ApiRequest {
    public static void main(String[] args) {
        HttpClient client = HttpClient.newHttpClient();
        String jsonRequest = "{\"query\": \"mutation CreateBite($transcriptId: ID!, $startTime: Float!, $endTime: Float!) { createBite(transcript_id: $transcriptId, start_time: $startTime, end_time: $endTime) { summary status id } }\", \"variables\": {\"transcriptId\": \"your_transcript_id\", \"startTime\": 0, \"endTime\": 5}}";
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.fireflies.ai/graphql"))
            .header("Content-Type", "application/json")
            .header("Authorization", "Bearer your_api_key")
            .POST(BodyPublishers.ofString(jsonRequest))
            .build();

        client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
            .thenApply(HttpResponse::body)
            .thenAccept(System.out::println)
            .join();
    }
}
```

--------------------------------

### Query active_meetings

Source: https://docs.fireflies.ai/llms-full.txt

GraphQL query to fetch active meetings. Includes arguments, usage example, and response example.

```APIDOC
## Query active_meetings

### Description
Fetches a list of currently active (in-progress) meetings for the authenticated user or, for admins, any user in their team.

### Method
POST

### Endpoint
https://api.fireflies.ai/graphql

### Parameters
#### Arguments
- **email** (String) - Optional - Filter active meetings by a specific user's email address. Regular users can only query their own active meetings (must pass their own email or omit this field). Admins can query active meetings for any user in their team. If omitted, returns active meetings for the authenticated user. The email must be valid and belong to a user in the same team as the requester.
- **states** ([MeetingState]) - Optional - Filter active meetings by their state. Accepts an array of MeetingState values. Possible values: `active` (meetings currently in progress), `paused` (meetings that have been paused). If omitted, returns meetings in both `active` and `paused` states by default.

### Request Example
```graphql
query ActiveMeetings($email: String, $states: [MeetingState!]) {
  active_meetings(input: { email: $email, states: $states }) {
    id
    title
    organizer_email
    meeting_link
    start_time
    end_time
    privacy
    state
  }
}
```

### Response
#### Success Response (200)
- **data.active_meetings** (array) - List of active meetings.
  - **id** (string) - Meeting ID.
  - **title** (string) - Meeting title.
  - **organizer_email** (string) - Email of the meeting organizer.
  - **meeting_link** (string) - URL to join the meeting.
  - **start_time** (string) - Start time of the meeting (ISO 8601).
  - **end_time** (string) - End time of the meeting (ISO 8601).
  - **privacy** (string) - Privacy setting of the meeting.
  - **state** (string) - Current state of the meeting (e.g., `active`, `paused`).

#### Response Example
```json
{
  "data": {
    "active_meetings": [
      {
        "id": "meeting-id-1",
        "title": "Team Standup",
        "organizer_email": "user@example.com",
        "meeting_link": "https://zoom.us/j/123456789",
        "start_time": "2024-01-15T10:00:00.000Z",
        "state": "active"
      },
      {
        "id": "meeting-id-2",
        "title": "Client Review",
        "organizer_email": "user@example.com",
        "meeting_link": "https://meet.google.com/abc-defg-hij",
        "start_time": "2024-01-15T14:30:00.000Z",
        "state": "paused"
      }
    ]
  }
}
```
```

--------------------------------

### Upload audio with webhook using Python (requests)

Source: https://docs.fireflies.ai/graphql-api/webhooks

Use this Python example with the requests library to upload an audio file and include a webhook URL. The webhook is passed in the input variables and will receive notifications for this upload only.

```python
import requests

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

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

input_data = {
	"url": "https://url_for_audio_file",
	"title": "title of the file",
	"webhook": "https://url_for_the_webhook"
}

data = {
	'query': '''
		mutation($input: AudioUploadInput) {
			uploadAudio(input: $input) {
				success
				title
				message
			}
		}
	''',
	'variables': {'input': input_data}
}

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

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

--------------------------------

### Create Bite with JavaScript (axios)

Source: https://docs.fireflies.ai/graphql-api/mutation/create-bite

Node.js/axios example to create a bite. Uses the same GraphQL mutation and variables as the curl example.

```javascript
const axios = require('axios');

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

const data = {
  query: `mutation CreateBite($transcriptId: ID!, $startTime: Float!, $endTime: Float!) {
			createBite(transcript_id: $transcriptId, start_time: $startTime, end_time: $endTime) {
				summary
				status
				id
			}
		}`,
  variables: { transcriptId: 'your_transcript_id', startTime: 0, endTime: 5 }
};

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

--------------------------------

### Python requests example to fetch AskFred thread

Source: https://docs.fireflies.ai/llms-full.txt

Python example using the requests library to send a GraphQL query to fetch an AskFred thread. Requires the requests package and a valid API key.

```python
import requests

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

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

thread_id = 'thread_abc123'

query = '''
    query GetAskFredThread($id: String!) {
        askfred_thread(id: $id) {
            id
            title
            transcript_id
            user_id
            created_at
            messages {
                id
                query
                answer
                suggested_queries
                status
                created_at
            }
        }
    }
'''

variables = {
    'id': thread_id
}

data = {
    'query': query,
    'variables': variables
}

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

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

--------------------------------

### Webhook Payload Example: meeting.bot_joined

Source: https://docs.fireflies.ai/graphql-api/webhooks-v2

Example payload for the meeting.bot_joined event. Contains the event type, timestamp in milliseconds, and the meeting identifier.

```json
{
  "event": "meeting.bot_joined",
  "timestamp": 1781258655914,
  "meeting_id": "01KTXMH9V8RPY1B4DTYKB27WYR"
}
```

--------------------------------

### ContinueAskFredThread Response Example

Source: https://docs.fireflies.ai/graphql-api/mutation/continue-askfred-thread

Example response from the continueAskFredThread mutation. Shows the message object with id, thread_id, query, answer, suggested_queries, status, and created_at. The answer is formatted in markdown and includes a detailed budget breakdown.

```json
{
  "data": {
    "continueAskFredThread": {
      "message": {
        "id": "msg_003",
        "thread_id": "thread_abc123",
        "query": "Can you provide more details about the budget allocation?",
        "answer": "Certainly! Here are the detailed budget allocations discussed in the meeting:\n\n## Q4 Budget Breakdown ($150K Total)\n\n### Engineering (60% - $90K)\n- **Infrastructure Improvements**: $30K\n  - Cloud services optimization\n  - Database scaling\n  - Security enhancements\n- **Feature Development**: $45K\n  - Mobile app features: $25K\n  - API v2 development: $20K\n- **Technical Debt**: $15K\n  - Code refactoring\n  - Legacy system migration\n\n### Design & UX (25% - $37.5K)\n- **User Research**: $10K\n- **Design System Updates**: $15K\n- **Prototype Development**: $12.5K\n\n### Marketing & Growth (15% - $22.5K)\n- **Content Creation**: $7.5K\n- **Paid Acquisition Tests**: $10K\n- **Partnership Development**: $5K\n\nThe CFO emphasized maintaining a 10% contingency within each category for unexpected costs.",
        "suggested_queries": [
          "Who is responsible for managing each budget category?",
          "What are the key milestones for the infrastructure improvements?",
          "How will the budget be tracked and reported?"
        ],
        "status": "completed",
        "created_at": "2024-03-15T10:35:00Z"
      }
    }
  }
}
```

--------------------------------

### Example webhook payload

Source: https://docs.fireflies.ai/graphql-api/webhooks

Example JSON payload sent to a webhook when an event fires. Contains meetingId, eventType, and clientReferenceId fields.

```json
{
  "meetingId": "ASxwZxCstx",
  "eventType": "Transcription completed",
  "clientReferenceId": "be582c46-4ac9-4565-9ba6-6ab4264496a8"
}
```

--------------------------------

### Channels Query Response Example

Source: https://docs.fireflies.ai/graphql-api/query/channels

Example response from the Channels query. Shows two channels: a public 'Engineering' channel and a private 'Private Project' channel, each with member details including user_id, email, and name.

```json
{
  "data": {
    "channels": [
      {
        "id": "channel-id-1",
        "title": "Engineering",
        "is_private": false,
        "members": [
          {
            "user_id": "user-id-1",
            "email": "john@example.com",
            "name": "John Doe"
          },
          {
            "user_id": "user-id-2",
            "email": "jane@example.com",
            "name": "Jane Smith"
          }
        ]
      },
      {
        "id": "channel-id-2",
        "title": "Private Project",
        "is_private": true,
        "members": [
          {
            "user_id": "user-id-1",
            "email": "john@example.com",
            "name": "John Doe"
          }
        ]
      }
    ]
  }
}
```
Tokens:
Raw