Update a meeting recording

POST/v1/meetings/{id}/recordings/{recordingId}

A recording is one session of the meeting: its transcript and, when there is one, its audio or video. Recordings come from the Lightfield notetaker, Gong, Granola, or an upload. Only uploaded recordings can be created or given media through the API. Changes only what is sent. isCanonical: true makes the recording the meeting primary, for any provider. mediaFileId adds or replaces the audio or video of an uploaded recording; a replaced file is deleted. Notetaker, Gong and Granola recordings cannot be given media. Only meeting participants and workspace owners may update.

Supports idempotency via the Idempotency-Key header.

Required scope: meetings:update

Rate limit category: Write

Path ParametersExpand Collapse

id: string

Unique identifier of the meeting.

recordingId: string

Unique identifier of the recording.

Body ParametersJSONExpand Collapse

isCanonical: optional boolean

true pins this as the meeting’s primary recording. Works for every provider, but the recording needs a transcript file (transcript is not null). false is rejected: to move the primary, set it on another recording.

mediaFileId: optional string

File ID of a completed upload with purpose meeting_recording. Adds or replaces the media; a replaced file is deleted. Uploaded recordings only.

ReturnsExpand Collapse

MeetingUpdateRecordingResponse object { id, isCanonical, media, 4 more }

id: string

Unique identifier of the recording.

isCanonical: boolean

Whether this is the meeting’s primary recording, the one summaries and $transcript use.

media: object { mimeType, url }

Playable audio or video. Null when the recording has none, such as a Granola note, a private Gong call, a failed notetaker recording or an upload without media.

mimeType: string

MIME type of the media, when known.

url: string

Short-lived download URL for the audio or video. Anyone with the URL can download it until it expires, so fetch it again when needed rather than storing it.

provider: "RECALL" or "GONG" or "GRANOLA" or "UPLOAD"

Where the recording came from: RECALL (Lightfield notetaker), GONG, GRANOLA, or UPLOAD.

One of the following:

"RECALL"

"GONG"

"GRANOLA"

"UPLOAD"

recordedAt: string

When the provider recorded it, in ISO 8601. Null if unknown.

recordedBy: string

Display name of who recorded or uploaded it. Not a member reference.

transcript: object { fileId }

The transcript text file. Null for older notetaker recordings.

fileId: string

File ID of the transcript. Read its text through GET /v1/files/{id}/url.

Update a meeting recording

curl https://api.lightfield.app/v1/meetings/$ID/recordings/$RECORDING_ID \
    -H 'Content-Type: application/json' \
    -H 'Lightfield-Version: 2026-03-01' \
    -H "Authorization: Bearer $API_KEY" \
    -d '{}'

{
  "id": "id",
  "isCanonical": true,
  "media": {
    "mimeType": "mimeType",
    "url": "url"
  },
  "provider": "RECALL",
  "recordedAt": "recordedAt",
  "recordedBy": "recordedBy",
  "transcript": {
    "fileId": "fileId"
  }
}

Returns Examples

{
  "id": "id",
  "isCanonical": true,
  "media": {
    "mimeType": "mimeType",
    "url": "url"
  },
  "provider": "RECALL",
  "recordedAt": "recordedAt",
  "recordedBy": "recordedBy",
  "transcript": {
    "fileId": "fileId"
  }
}