Skip to content

List a meeting's recordings

meeting.list_recordings(strid) -> MeetingListRecordingsResponse
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: str

Unique identifier of the meeting.

ReturnsExpand Collapse
class MeetingListRecordingsResponse: …
data: List[Data]

Every recording on the meeting. Media is not included.

id: str

Unique identifier of the recording.

is_canonical: bool

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

provider: Literal["RECALL", "GONG", "GRANOLA", "UPLOAD"]

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

One of the following:
"RECALL"
"GONG"
"GRANOLA"
"UPLOAD"
recorded_at: Optional[str]

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

recorded_by: Optional[str]

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

transcript: Optional[DataTranscript]

The transcript text file. Null for older notetaker recordings.

file_id: str

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

object: str

Always list.

List a meeting's recordings

from lightfield import Lightfield

client = Lightfield(
    api_key="My API Key",
)
meeting_list_recordings_response = client.meeting.list_recordings(
    "id",
)
print(meeting_list_recordings_response.data)
{
  "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"
}