​
Overview

This section serves as a primer on the essential features of the Fireflies API. It covers the requirements to make authenticated requests to the Fireflies API, key GraphQL concepts and a breakdown of core components like queries, mutations, schema and data types.

​
Host

The Fireflies API is hosted at https://api.fireflies.ai

​
Authorization

The Fireflies API requires a valid API key for all requests. Please see Authorization for more information

​
GraphQL API Concepts

Welcome to our GraphQL API! GraphQL is a powerful query language designed for APIs, offering clients the ability to request exactly what they need and nothing more.

​
Queries

Queries are used to fetch data in GraphQL. They are akin to the GET request in REST. A basic query might look like this:
Queries are read-only and won’t modify your data.
graphql
query {
  user(id: "1") {
    name
    email
  }
}

​
Mutations

Mutations allow you to modify data – create, update, or delete.
Mutations should be used with caution as they change server-side data.
graphql
mutation {
  setUserRole(user_id: "1", role: "user") {
    id
    name
  }
}

​
Schema and Types

​
Schema Definition

The schema defines the API’s capabilities, including types, queries, mutations, and more.

​
Understanding GraphQL Schema

The schema is a contract between client and server, defining how clients can access data.

​
Data Types

Standard Types: Int, Float, String, Boolean, ID. Custom Types: Defining complex data structures. Custom types are user-defined and can include combinations of standard types.

​
Best Practices

  1. Optimize query performance by requesting for only necessary data.
  2. Use variables in queries to enhance readability and flexibility

​
Additional Resources

For more in-depth information, visit GraphQL Documentation.

LLM-based Development

Enhance your AI coding experience with LLM readable documentation

Limits

File size and API rate limits for the Fireflies API