Skip to main content

Overview

The updateMeetingState mutation allows you to pause or resume recording for a live meeting through the API. This is useful for controlling the Fireflies bot during an active meeting. This mutation is rate-limited to 10 requests per hour across all user tiers.

Arguments

input
UpdateMeetingStateInput!
required
Input object containing the meeting ID and action to perform. See UpdateMeetingStateInput for details.

Response

success
Boolean!
Whether the action was executed successfully
action
MeetingStateAction!
The action that was executed

Usage Example

To update the meeting state, provide the meeting ID and the desired action:
mutation UpdateMeetingState($input: UpdateMeetingStateInput!) {
  updateMeetingState(input: $input) {
    success
    action
  }
}
curl -X POST https://api.fireflies.ai/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your_api_key" \
  -d '{
    "query": "mutation UpdateMeetingState($input: UpdateMeetingStateInput!) { updateMeetingState(input: $input) { success action } }",
    "variables": {
      "input": {
        "meeting_id": "your_meeting_id",
        "action": "pause_recording"
      }
    }
  }'
{
  "data": {
    "updateMeetingState": {
      "success": true,
      "action": "pause_recording"
    }
  }
}

Error Codes

List of possible error codes that may be returned by the updateMeetingState mutation. Full list of error codes can be found here.

The user account has been cancelled. Please contact support if you encounter this error.

The meeting with the specified ID was not found or you do not have access to it.

You do not have permission to control this meeting. Only the meeting organizer or team admin can update the meeting state.

You have exceeded the rate limit for this mutation. The limit is 10 requests per hour. Please wait before making additional requests.

Additional Resources