2.6 KiB
Fireflies API Reference
Model and Auth
Fireflies exposes GraphQL at https://api.fireflies.ai/graphql. Send JSON with query, optional
variables, and optional operationName; authenticate with Authorization: Bearer <API key>.
Queries are read-only. Mutations create, update, or delete server-side state.
Use scripts/fireflies query and scripts/fireflies mutation as the compatibility escape hatch
for every documented current or future operation. The CLI rejects mutations on query, queries on
mutation, and requires --confirm for a non-dry-run generic mutation.
Documented Families
| Family | Documented operation |
|---|---|
| Meetings | transcripts, transcript, deleteTranscript, updateMeetingTitle, updateMeetingPrivacy, updateMeetingState, shareMeeting, revokeSharedMeetingAccess |
| Workspace | user, users, contacts, channels, channel, user_groups |
| Content | bites, bite, createBite, apps, analytics |
| Live | active_meetings, live_action_items, createLiveActionItem |
| Automation | auditEvents, rule_executions_by_meeting, uploadAudio |
| AskFred | askfred_threads, askfred_thread, createAskFredThread, continueAskFredThread, deleteAskFredThread |
The ergonomic CLI documents use conservative selections. live add calls
createLiveActionItem(input: CreateLiveActionItemInput!) with meeting_id and prompt only.
Use the generic mutation escape hatch for Add to Live (addToLiveMeeting) or any operation not
represented by an ergonomic command. Use introspection only through schema introspect; availability
depends on the deployment.
Pagination and Limits
transcripts uses limit plus skip, with a documented maximum limit of 50. The CLI rejects a
higher value. Bites also support limit and skip; their list query requires one of mine,
transcript_id, or my_team. Respect plan limits: Free is 50 requests/day, Pro 500/day, and
Business/Enterprise 60/minute. Add to Live is 3 per 20 minutes, meeting sharing is 10/hour, and
deleteTranscript is 10/minute.
Errors and Access
GraphQL errors are returned in errors and can include message, code, friendly, and
extensions.helpUrls. The CLI preserves that response on stdout in JSON mode and exits 5.
too_many_requests can include retryAfter; delay before retrying. Audit events and rule execution
logs have Enterprise/admin restrictions. Do not infer the caller's plan or authorization locally.
AskFred mutations require AI credits.
Primary Sources
See source-index.md for dated primary documentation URLs and claim scope.