Skip to content

Retrieve a meeting recording

client.Meeting.GetRecording(ctx, recordingID, query) (*MeetingRetrieveRecordingResponse, error)
GET/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. Returns the recording with a short-lived media.url for its audio or video. For notetaker and Gong recordings the URL is fetched from the provider on each call. 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
recordingID string

Unique identifier of the recording.

query MeetingGetRecordingParams
ID param.Field[string]

Unique identifier of the meeting.

ReturnsExpand Collapse
type MeetingRetrieveRecordingResponse struct{…}
ID string

Unique identifier of the recording.

IsCanonical bool

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

Media MeetingRetrieveRecordingResponseMedia

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 MeetingRetrieveRecordingResponseProvider

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

One of the following:
const MeetingRetrieveRecordingResponseProviderRecall MeetingRetrieveRecordingResponseProvider = "RECALL"
const MeetingRetrieveRecordingResponseProviderGong MeetingRetrieveRecordingResponseProvider = "GONG"
const MeetingRetrieveRecordingResponseProviderGranola MeetingRetrieveRecordingResponseProvider = "GRANOLA"
const MeetingRetrieveRecordingResponseProviderUpload MeetingRetrieveRecordingResponseProvider = "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 MeetingRetrieveRecordingResponseTranscript

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.

Retrieve a meeting recording

package main

import (
  "context"
  "fmt"

  "github.com/Lightfld/lightfield-go"
  "github.com/Lightfld/lightfield-go/option"
)

func main() {
  client := githubcomlightfldlightfieldgo.NewClient(
    option.WithAPIKey("My API Key"),
  )
  meetingRetrieveRecordingResponse, err := client.Meeting.GetRecording(
    context.TODO(),
    "recordingId",
    githubcomlightfldlightfieldgo.MeetingGetRecordingParams{
      ID: "id",
    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", meetingRetrieveRecordingResponse.ID)
}
{
  "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"
  }
}