## Upload a meeting recording

`client.Meeting.NewRecording(ctx, id, body) (*MeetingCreateRecordingResponse, error)`

**post** `/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. Creates an uploaded recording from files already uploaded through `POST /v1/files`: a transcript (purpose `meeting_transcript`, required) and optionally its audio or video (purpose `meeting_recording`). Both files attach in one write, so a failed request attaches neither. Media can also be added later by updating the recording. Sending a transcript file that is already on the meeting returns that recording. Only meeting participants and workspace owners may upload.

Supports idempotency via the `Idempotency-Key` header.

**[Required scope](/using-the-api/scopes/):** `meetings:update`

**[Rate limit category](/using-the-api/rate-limits/):** Write

### Parameters

- `id string`

  Unique identifier of the meeting.

- `body MeetingNewRecordingParams`

  - `TranscriptFileID param.Field[string]`

    File ID of a completed upload with purpose `meeting_transcript`.

  - `IsCanonical param.Field[bool]`

    Pin this as the meeting's primary recording. Defaults to `true`. `false` attaches it without pinning; on a meeting with no pinned recording, the primary is chosen by source (notetaker, Gong, Granola, then uploads) and then recency, so a newer upload can still become primary.

  - `MediaFileID param.Field[string]`

    File ID of a completed upload with purpose `meeting_recording`. Can also be added later by updating the recording.

### Returns

- `type MeetingCreateRecordingResponse 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 MeetingCreateRecordingResponseMedia`

    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 MeetingCreateRecordingResponseProvider`

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

    - `const MeetingCreateRecordingResponseProviderRecall MeetingCreateRecordingResponseProvider = "RECALL"`

    - `const MeetingCreateRecordingResponseProviderGong MeetingCreateRecordingResponseProvider = "GONG"`

    - `const MeetingCreateRecordingResponseProviderGranola MeetingCreateRecordingResponseProvider = "GRANOLA"`

    - `const MeetingCreateRecordingResponseProviderUpload MeetingCreateRecordingResponseProvider = "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 MeetingCreateRecordingResponseTranscript`

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

### Example

```go
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"),
  )
  meetingCreateRecordingResponse, err := client.Meeting.NewRecording(
    context.TODO(),
    "id",
    githubcomlightfldlightfieldgo.MeetingNewRecordingParams{
      TranscriptFileID: "transcriptFileId",
    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", meetingCreateRecordingResponse.ID)
}
```

#### Response

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