Skip to main content

​
Overview

The updateMeetingChannel mutation allows for batch updating the channel assignment of multiple meeting transcripts. This operation requires admin privileges within the team or ownership of the meetings. You can update 1–5 transcripts at once with all-or-nothing semantics—if any transcript fails validation, none are updated.

​
Arguments

​
input
UpdateMeetingChannelInput
required
The channel assignment to be applied to the specified transcripts. See UpdateMeetingChannelInput.

​
Usage Example

To update meeting channels, provide an array of transcript IDs (1–5 items) and a single channel ID as arguments to the mutation. Here’s an example of how this mutation could be used: 
mutation UpdateMeetingChannel($input: UpdateMeetingChannelInput!) {
  updateMeetingChannel(input: $input) {
    id
    title
    channels {
      id
    }
  }
}

curl -X POST https://api.fireflies.ai/graphql \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer your_api_key" \
	-d '{
		"query": "mutation($input: UpdateMeetingChannelInput!) { updateMeetingChannel(input: $input) { id title channels { id } } }",
		"variables": {
			"input": {
				"transcript_ids": ["transcript_id_1", "transcript_id_2"],
				"channel_id": "channel_id"
			}
		}
	}'

{
  "data": {
    "updateMeetingChannel": [
      {
        "id": "transcript_id_1",
        "title": "Weekly Sync",
        "channels": [
          {
            "id": "channel_id"
          }
        ]
      },
      {
        "id": "transcript_id_2",
        "title": "Product Review",
        "channels": [
          {
            "id": "channel_id"
          }
        ]
      }
    ]
  }
}

​
FAQ

Only users with admin privileges or meeting owners can update meeting channels. All specified meetings must be owned by users in your team.

You can update between 1 and 5 transcripts in a single mutation call. If you need to update more transcripts, make multiple mutation calls.

The mutation uses all-or-nothing semantics. If any transcript fails validation (not found, no access, or permission denied), none of the transcripts will be updated. All transcripts must pass validation for the update to succeed.

No, a meeting can only belong to one channel at a time. This mutation sets the meeting’s channel to the specified value, replacing any previous channel assignment.

No, the response order is not guaranteed to match the input order of transcript_ids. If you need to correlate responses with inputs, use the id field in the response.

​
Error Codes

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

The user must be either the meeting owner or a team admin to update meeting channels.

One or more specified transcripts could not be found or you do not have access to them.

The input failed validation. Common causes include: empty transcript_ids array, more than 5 transcript_ids, or missing/empty channel_id.

​
Additional Resources

Transcript

Querying transcript details

Update Meeting Title

Update meeting titles

Update Meeting Privacy

Update meeting privacy

Transcripts

Querying list of transcripts