Skip to content

List a meeting's recordings

$ lightfield meeting list-recordings
GET/v1/meetings/{id}/recordings

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. Returns every recording on the meeting without media URLs; retrieve a single recording for its media. Requires full access to the meeting; a caller who sees only its metadata gets a 403.

Required scope: meetings:read

Rate limit category: Read

ParametersExpand Collapse
--id: string

Unique identifier of the meeting.

ReturnsExpand Collapse
meeting_list_recordings_response: object { data, object }
data: array of object { id, isCanonical, provider, 3 more }

Every recording on the meeting. Media is not included.

id: string

Unique identifier of the recording.

isCanonical: boolean

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

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

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

"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.

object: string

Always list.

List a meeting's recordings

lightfield meeting list-recordings \
  --api-key 'My API Key' \
  --id id
{
  "data": [
    {
      "id": "id",
      "isCanonical": true,
      "provider": "RECALL",
      "recordedAt": "recordedAt",
      "recordedBy": "recordedBy",
      "transcript": {
        "fileId": "fileId"
      }
    }
  ],
  "object": "object"
}
Returns Examples
{
  "data": [
    {
      "id": "id",
      "isCanonical": true,
      "provider": "RECALL",
      "recordedAt": "recordedAt",
      "recordedBy": "recordedBy",
      "transcript": {
        "fileId": "fileId"
      }
    }
  ],
  "object": "object"
}