Files
magnus919_agent-skills/fireflies/references/workflows.md
T

2.7 KiB

Workflows

List, Filter, and Read a Transcript

Use this to locate meetings and then inspect their content.

scripts/fireflies transcripts list --keyword roadmap --organizers owner@example.com --limit 10 --json
scripts/fireflies transcripts get transcript-id --json

The detailed query includes summary, speakers, sentences, and analytics.

Fetch Recording Download URLs

Use this to grab the meeting's audio and video recordings. The response's video_url and audio_url fields are the download links for the recording.

scripts/fireflies transcripts get transcript-id --json
# response includes "video_url" and "audio_url" — signed download links for the recording

Extract Actions and Summary

Use this for a currently live meeting or for a completed transcript.

scripts/fireflies live-action-items meeting-id --json
scripts/fireflies transcripts get transcript-id --json

Team Analytics

Use a bounded time range for trend reporting.

scripts/fireflies analytics --start 2026-01-01 --end 2026-01-31 --json

Upload Audio with Webhook Correlation

Use a publicly retrievable HTTPS media URL and a webhook endpoint you control. Preview first.

scripts/fireflies audio upload --url https://media.example/call.mp3 --webhook https://app.example/fireflies --client-reference-id import-42 --dry-run --json
scripts/fireflies audio upload --url https://media.example/call.mp3 --webhook https://app.example/fireflies --client-reference-id import-42 --confirm --json

Upload a File (Two-Phase)

Use this when the media is not on a public URL and you must push the bytes yourself.

scripts/fireflies audio create-upload --content-type audio/wav --file-size 5242880 --dry-run --json
scripts/fireflies audio create-upload --content-type audio/wav --file-size 5242880 --confirm --json
# PUT the file to upload_url from the response, then:
scripts/fireflies audio confirm-upload --meeting-id meeting-id --confirm --json

AskFred Conversation

Use AskFred for natural-language analysis when the account has AI credits.

scripts/fireflies askfred create --question 'What decisions were made?' --transcript-id transcript-id --confirm --json
scripts/fireflies askfred continue thread-id --question 'Who owns the follow-up?' --confirm --json

Generic GraphQL

Use this when a documented operation is newer than the CLI's ergonomic commands. Copy the document from Fireflies primary documentation, pass variables as JSON, and preview mutations before confirmation.

scripts/fireflies query --document 'query { user { name } }' --json
scripts/fireflies mutation --document 'mutation Example($input: SomeInput!) { someMutation(input: $input) { success } }' --variables '{"input":{}}' --dry-run --json