Overview
TheauditEvents query retrieves audit events for your team. Events follow the OCSF v1.5.0 standard and cover meeting operations, team operations, user settings changes, and authentication (login/logout) events.
This query requires an Enterprise plan and the requesting user must be a team admin. See pricing for more details.
Supported Events
| Action | Category | Description |
|---|---|---|
MEETING_DELETED | Meeting Operations | A meeting was deleted |
MEETING_PRIVACY_UPDATED | Meeting Operations | Meeting privacy setting was changed |
MEETING_VIEWED | Meeting Operations | A meeting summary was viewed |
MEETING_SHARED | Meeting Operations | A meeting was shared with someone |
MEETING_ACCESS_REVOKED | Meeting Operations | A user’s access to a shared meeting was revoked |
MEETING_DOWNLOADED | Meeting Operations | A meeting transcript or recording was downloaded |
MEETING_TITLE_UPDATED | Meeting Operations | A meeting’s title was changed |
MEETING_MOVED_TO_CHANNEL | Meeting Operations | One or more meetings were moved to a channel |
SOUNDBITE_CREATED | Meeting Operations | A soundbite was created from a meeting |
ASKFRED_THREAD_CREATED | Meeting Operations | An AskFred thread was created |
ASKFRED_THREAD_CONTINUED | Meeting Operations | An AskFred thread was continued |
ASKFRED_THREAD_DELETED | Meeting Operations | An AskFred thread was deleted |
ASKFRED_THREADS_LISTED | Meeting Operations | AskFred threads were listed |
ASKFRED_THREAD_VIEWED | Meeting Operations | An AskFred thread was viewed |
MEETING_STATE_UPDATED | Meeting Operations | Meeting recording state was changed |
LIVE_ACTION_ITEM_CREATED | Meeting Operations | A live action item was created |
LIVE_ACTION_ITEMS_VIEWED | Meeting Operations | Live action items were viewed |
LIVE_SOUNDBITE_CREATED | Meeting Operations | A live soundbite was created |
MEETING_UPLOAD_CREATED | Meeting Operations | An upload URL was created for a new meeting recording |
MEETING_UPLOAD_CONFIRMED | Meeting Operations | A meeting recording upload was confirmed and sent for processing |
LIVE_MEETING_BOT_REQUESTED | Meeting Operations | A bot was requested to join a live meeting |
MEETING_AUDIO_UPLOADED | Meeting Operations | Audio was uploaded for transcription |
RULE_EXECUTIONS_VIEWED | Team Operations | Rule executions were viewed |
APP_OUTPUTS_VIEWED | Meeting Operations | App outputs were viewed |
TEAMMATE_ADDED | Team Operations | A teammate was added to the team |
TEAMMATE_REMOVED | Team Operations | A teammate was removed from the team |
USER_ROLE_CHANGED | User Operations | A teammate’s role was changed |
USERS_LISTED | User Operations | Users on a team were listed |
USER_VIEWED | User Operations | A user profile was viewed |
USER_GROUPS_LISTED | Team Operations | User groups were listed |
USER_GROUP_MEMBER_ADDED | Team Operations | A teammate was added to a user group |
USER_GROUP_MEMBER_REMOVED | Team Operations | A teammate was removed from a user group |
SETTINGS_UPDATED | User Operations | Team settings were updated |
LOGIN | Authentication | A user logged in |
LOGOUT | Authentication | A user logged out |
Arguments
Pagination cursor for fetching the next page of results. Use the
next_cursor value from a
previous response.Filters for the query. The
category field is required.Show Filter properties
Show Filter properties
Event category (required):
MEETING_OPERATIONS, TEAM_OPERATIONS, USER_OPERATIONS, or AUTHENTICATION.Response Fields
List of audit events matching the query.
Show Event properties
Show Event properties
Event category:
MEETING_OPERATIONS, TEAM_OPERATIONS, USER_OPERATIONS, or AUTHENTICATION.Additional context as a JSON string of key-value pairs, or
Moving several meetings at once records one event per meeting, each carrying the same
null when the action carries none.Which keys appear depends on the action. Events written by the Public API and MCP use:| Action | Keys |
|---|---|
MEETING_DELETED | deleteMode |
MEETING_PRIVACY_UPDATED | privacy |
MEETING_SHARED | inviteeCount |
MEETING_MOVED_TO_CHANNEL | channelId, meetingCount |
SOUNDBITE_CREATED | biteId |
ASKFRED_THREAD_CREATED | meetingId, messageId |
ASKFRED_THREAD_CONTINUED | meetingId, messageId |
ASKFRED_THREADS_LISTED | meetingId, threadCount |
ASKFRED_THREAD_VIEWED | messageCount |
MEETING_STATE_UPDATED | recordingAction |
LIVE_ACTION_ITEMS_VIEWED | itemCount |
MEETING_UPLOAD_CREATED | contentType, fileSize |
LIVE_MEETING_BOT_REQUESTED | duration |
MEETING_AUDIO_UPLOADED | clientReferenceId |
RULE_EXECUTIONS_VIEWED | meetingId, meetingCount |
APP_OUTPUTS_VIEWED | appId, outputCount |
USER_ROLE_CHANGED | role |
USERS_LISTED | userCount |
USER_GROUPS_LISTED | groupCount, level |
USER_GROUP_MEMBER_ADDED | groupId |
USER_GROUP_MEMBER_REMOVED | groupId |
meetingCount — the size of the batch the action moved, not a per-event count. Group
such events by time and actor to reconstruct a single bulk operation.On MEETING_DELETED, deleteMode is deleted when the meeting was deleted for everyone,
or removed when a co-owner only removed it from their own account and the other owners
keep it.source identifies where the action came from: api (Public API), mcp (MCP server),
web (Fireflies web app), or fireflies_support (action taken by Fireflies support).
It is omitted when the surface can’t be identified. Actions recorded by other Fireflies
services may carry their own keys. Treat the object as open:
new keys can be added for an action without notice, so read the keys you need rather than
assuming an exact shape.token_type records how the actor authenticated: api_key (personal API key), oauth
(an authorized OAuth/MCP client), or service (a Fireflies service acting on the user’s
behalf). When it is api_key, api_key_id carries the identifier of the key that performed
the action (never the key value), so admins can attribute activity to a specific key and
correlate it with key creation/reset events. Both are omitted when the surface can’t be
identified.Usage Example
query AuditEvents($limit: Int, $filters: AuditEventFiltersInput!) {
auditEvents(limit: $limit, filters: $filters) {
events {
id
time
category
action
severity
status
message
actor {
user_id
email
full_name
ip_address
}
resource {
type
id
}
metadata
}
has_more
next_cursor
}
}
curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer your_api_key" \
--data '{ "query": "query { auditEvents(limit: 10, filters: { category: MEETING_OPERATIONS }) { events { id time action actor { user_id } resource { type id } } has_more next_cursor } }" }' \
https://api.fireflies.ai/graphql
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 AuditEvents($limit: Int, $filters: AuditEventFiltersInput) {
auditEvents(limit: $limit, filters: $filters) {
events {
id
time
category
action
message
actor { user_id email }
resource { type id }
}
has_more
next_cursor
}
}`,
variables: {
limit: 10,
filters: { category: 'MEETING_OPERATIONS' },
},
};
axios
.post(url, data, { headers: headers })
.then((response) => {
console.log(response.data);
})
.catch((error) => {
console.error(error);
});
import requests
url = 'https://api.fireflies.ai/graphql'
headers = {
'Content-Type': 'application/json',
'Authorization': 'Bearer your_api_key'
}
query = '''
query AuditEvents($limit: Int, $filters: AuditEventFiltersInput) {
auditEvents(limit: $limit, filters: $filters) {
events {
id
time
category
action
message
actor { user_id email }
resource { type id }
}
has_more
next_cursor
}
}
'''
data = {
'query': query,
'variables': {
'limit': 10,
'filters': { 'category': 'MEETING_OPERATIONS' }
}
}
response = requests.post(url, headers=headers, json=data)
print(response.json())
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class ApiRequest {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
String json = "{\"query\":\"query { auditEvents(limit: 10, filters: { category: MEETING_OPERATIONS }) { events { id time action actor { user_id } resource { type id } } has_more next_cursor } }\"}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.fireflies.ai/graphql"))
.header("Content-Type", "application/json")
.header("Authorization", "Bearer your_api_key")
.POST(HttpRequest.BodyPublishers.ofString(json))
.build();
client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
.thenApply(HttpResponse::body)
.thenAccept(System.out::println)
.join();
}
}
{
"data": {
"auditEvents": {
"events": [
{
"id": "682e3a1b-f4c2-4d9a-b1e7-8c5d3f2a1b0c",
"time": "2026-04-25T10:30:00.000Z",
"category": "MEETING_OPERATIONS",
"action": "MEETING_SHARED",
"severity": "informational",
"status": "success",
"message": "share_meeting by alice@example.com",
"actor": {
"user_id": "user_abc123",
"email": "alice@example.com",
"full_name": "Alice Johnson",
"ip_address": "192.168.1.1"
},
"resource": {
"type": "meeting",
"id": "01K8DV541XM97WMGRCX66TPSWG"
},
"metadata": "{\"shareType\":\"email\",\"inviteeCount\":\"2\"}"
},
{
"id": "7a1c4d5e-2b3f-4a8c-9d0e-1f2a3b4c5d6e",
"time": "2026-04-25T09:15:00.000Z",
"category": "MEETING_OPERATIONS",
"action": "MEETING_DELETED",
"severity": "informational",
"status": "success",
"message": "delete_meeting by bob@example.com",
"actor": {
"user_id": "user_def456",
"email": "bob@example.com",
"full_name": "Bob Smith",
"ip_address": null
},
"resource": {
"type": "meeting",
"id": "01L2XY789ABC"
},
"metadata": null
}
],
"has_more": true,
"next_cursor": "eyJpZCI6IjdhMWM0ZDVlIn0="
}
}
}
Pagination
Use cursor-based pagination to fetch additional results:query {
auditEvents(limit: 20, cursor: "eyJpZCI6IjdhMWM0ZDVlIn0=", filters: { category: MEETING_OPERATIONS }) {
events {
id
time
action
}
has_more
next_cursor
}
}
OCSF Compliance
All events conform to the OCSF v1.5.0 standard. Theclass_uid, activity_id, and type_uid fields map directly to OCSF event classification, enabling integration with SIEM tools and compliance pipelines.
| Action | OCSF Class | class_uid | activity_id |
|---|---|---|---|
MEETING_DELETED | API Activity | 6003 | 4 |
MEETING_PRIVACY_UPDATED | Entity Management | 3004 | 3 |
MEETING_VIEWED | Web Resource Activity | 6001 | 2 |
MEETING_SHARED | User Access Management | 3005 | 1 |
MEETING_DOWNLOADED | Web Resource Activity | 6001 | 7 |
TEAMMATE_ADDED | User Access Management | 3005 | 1 |
TEAMMATE_REMOVED | User Access Management | 3005 | 2 |
SETTINGS_UPDATED | Entity Management | 3004 | 3 |
LOGIN | Authentication | 3002 | 1 |
LOGOUT | Authentication | 3002 | 2 |
Error Codes
List of possible error codes that may be returned by theauditEvents query. Full list of error codes can be found here.
paid_required (enterprise)
paid_required (enterprise)
You need to be on an Enterprise plan to query audit events.
require_elevated_privilege
require_elevated_privilege
You need to be a team admin to query audit events.
service_unavailable
service_unavailable
The audit service is temporarily unavailable. Please try again later.
Additional Resources
Transcripts
Querying list of transcripts
Rule Executions
Querying automation rule executions