Fireflies.ai Data Handling
Overview
Manage meeting transcript data: export in multiple formats (JSON, text, SRT), redact PII from transcripts and summaries, implement retention policies with automated cleanup, and handle GDPR/CCPA data subject requests.
Prerequisites
FIREFLIES_API_KEY configured- Understanding of transcript data structure (sentences, summary, analytics)
- Storage for processed transcripts
Instructions
Step 1: Fetch Transcript Data
const FIREFLIES_API = "https://api.fireflies.ai/graphql";
async function getFullTranscript(id: string) {
const res = await fetch(FIREFLIES_API, {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: `Bearer ${process.env.FIREFLIES_API_KEY}`,
},
body: JSON.stringify({
query: `
query($id: String!) {
transcript(id: $id) {
id title date duration
organizer_email
speakers { id name }
sentences { speaker_name text start_time end_time }
summary { overview action_items keywords short_summary }
meeting_attendees { displayName email }
}
}
`,
variables: { id },
}),
});
const json = await res.json();
if (json.errors) throw new Error(json.errors[0].message);
return json.data.transcript;
}
Step 2: Export in Multiple Formats
type ExportFormat = "json" | "text" | "srt" | "csv";
function exportTranscript(transcript: any, format: ExportFormat): string {
switch (format) {
case "json":
return JSON.stringify(transcript, null, 2);
case "text":
const lines = [
`# ${transcript.title}`,
`Date: ${transcript.date} | Duration: ${transcript.duration}min`,
`Speakers: ${transcript.speakers.map((s: any) => s.name).join(", ")}`,
"",
"## Summary",
transcript.summary?.overview || "(none)",
"",
"## Action Items",
...(transcript.summary?.action_items || []).map((a: string) => `- ${a}`),
"",
"## Transcript",
...transcript..(
),
];
lines.();
:
transcript..(
[
i + ,
,
,
,
].()
).();
:
header = ;
rows = transcript..(
Step 3: PII Redaction
const PII_PATTERNS = [
{ regex: /\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}\b/g, tag: "[EMAIL]" },
{ regex: /\b\d{3}[-.]?\d{3}[-.]?\d{4}\b/g, tag: "[PHONE]" },
{ regex: /\b\d{3}-\d{2}-\d{4}\b/g, tag: "[SSN]" },
{ regex: /\b\d{4}[\s-]?\d{4}[\s-]?\d{4}[\s-]?\d{4}\b/g, tag: "[CARD]" },
{ regex: /\b\d{1,5}\s+\w+\s+(Street|St|Avenue|Ave|Road|Rd|Drive|Dr|Lane|Ln)\b/gi, tag: "[ADDRESS]" },
];
function redactText(text: string): string {
let result = text;
for (const { regex, tag } of PII_PATTERNS) {
result = result.replace(regex, tag);
}
return result;
}
function redactTranscript(transcript: any): any {
return {
...transcript,
organizer_email: redactText(transcript.organizer_email || ""),
sentences: transcript.?.( ({
...s,
: (s.),
: s.,
})),
: transcript. ? {
...transcript.,
: (transcript.. || ),
: transcript..?.(redactText),
: (transcript.. || ),
} : ,
: transcript.?.( ({
: a.,
: (a. || ),
})),
};
}
Step 4: Retention Policy with Automated Cleanup
interface RetentionPolicy {
fullTranscriptDays: number;
summaryDays: number;
deleteAfterDays: number;
}
const DEFAULT_POLICY: RetentionPolicy = {
fullTranscriptDays: 90,
summaryDays: 365,
deleteAfterDays: 730,
};
async function applyRetentionPolicy(policy = DEFAULT_POLICY) {
const data = await getTranscriptList(200);
const now = Date.now();
const results = { kept: 0, archived: 0, deleted: 0 };
for (const t of data.transcripts) {
const ageDays = (now - new Date(t.date).getTime()) / 86400000;
if (ageDays > policy.deleteAfterDays) {
(t.);
results.++;
} (ageDays > policy.) {
(t.);
results.++;
} {
results.++;
}
}
.();
results;
}
() {
(, {
: ,
: {
: ,
: ,
},
: .({
: ,
: { id },
}),
});
( (r, ));
}
Step 5: GDPR Data Subject Request
async function handleDataSubjectDeletion(email: string) {
const data = await fetch(FIREFLIES_API, {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: `Bearer ${process.env.FIREFLIES_API_KEY}`,
},
body: JSON.stringify({
query: `query($participants: [String]) {
transcripts(participants: $participants, limit: 100) {
id title date participants
}
}`,
variables: { participants: [email] },
}),
}).then(r => r.json());
const affected = data.data.transcripts;
console.log(`Found ${affected.length} transcripts with ${email}`);
return {
email,
affectedTranscripts: affected.length,
transcriptIds: affected.( t.),
};
}
Error Handling
| Issue | Cause | Solution |
|---|
| Missing sentences | Transcript still processing | Check before export |
| PII in action items | Redaction only on sentences | Redact summary fields too (Step 3 does this) |
| Delete rate limit | 10 deletes/min | Add 6.5s delay between deletes |
| Large transcript OOM | 2+ hour meeting | Stream or paginate sentences |
Output
- Multi-format transcript export (JSON, text, SRT, CSV)
- PII redaction covering sentences, summaries, and attendee info
- Automated retention policy with configurable thresholds
- GDPR/CCPA data subject request handler
Resources
Next Steps
For enterprise access control, see fireflies-enterprise-rbac.
