---
title: "Return Notetaker media links"
method: GET
path: "/v3/grants/{grant_id}/notetakers/{notetaker_id}/media"
tags: ["Notetaker"]
---

# Return Notetaker media links

`GET /v3/grants/{grant_id}/notetakers/{notetaker_id}/media`

## Request

- Base URL: `https://api.us.nylas.com`
- URL: `https://api.us.nylas.com/v3/grants/{grant_id}/notetakers/{notetaker_id}/media`
- Auth: HTTP bearer

Returns a list of links to media generated by the specified Notetaker bot.

## Response `200`

Success. Returns Notetaker media.

- object
  - `request_id` string: The request ID.
  - `data` object: The media files for a Notetaker. Each file is present only if Nylas generated it. The recording, transcript, summary, and action items also require the matching Notetaker setting.
    - `action_items` object: Details about the action items from the meeting.
      - `created_at` number: When the file was created, in seconds using the Unix timestamp format.
      - `expires_at` number: When the file will be deleted from the Nylas servers, in seconds using the Unix timestamp format.
      - `name` string: The file name.
      - `size` integer: The size of the file, in bytes.
      - `ttl` number: Seconds remaining until the file is deleted from Nylas servers. This is the difference between `expires_at` and the time when you made your request. Download URLs expire separately, 60 minutes after they're generated.
      - `type` string: The file type.
      - `url` string: A link to the action items.
    - `recording` object: Details about the meeting recording.
      - `created_at` number: When the file was created, in seconds using the Unix timestamp format.
      - `duration` integer: The duration of the recording, in seconds.
      - `expires_at` number: When the file will be deleted from the Nylas servers, in seconds using the Unix timestamp format.
      - `name` string: The file name.
      - `size` integer: The size of the file, in bytes.
      - `ttl` number: Seconds remaining until the file is deleted from Nylas servers. This is the difference between `expires_at` and the time when you made your request. Download URLs expire separately, 60 minutes after they're generated.
      - `type` string: The file type.
      - `url` string: A link to the meeting recording.
    - `summary` object: Details about the meeting summary.
      - `created_at` number: When the file was created, in seconds using the Unix timestamp format.
      - `expires_at` number: When the file will be deleted from the Nylas servers, in seconds using the Unix timestamp format.
      - `name` string: The file name.
      - `size` integer: The size of the file, in bytes.
      - `ttl` number: Seconds remaining until the file is deleted from Nylas servers. This is the difference between `expires_at` and the time when you made your request. Download URLs expire separately, 60 minutes after they're generated.
      - `type` string: The file type.
      - `url` string: A link to the summary.
    - `thumbnail` object: Details about the meeting thumbnail.
      - `created_at` number: When the file was created, in seconds using the Unix timestamp format.
      - `expires_at` number: When the file will be deleted from the Nylas servers, in seconds using the Unix timestamp format.
      - `name` string: The file name.
      - `size` integer: The size of the file, in bytes.
      - `ttl` number: Seconds remaining until the file is deleted from Nylas servers. This is the difference between `expires_at` and the time when you made your request. Download URLs expire separately, 60 minutes after they're generated.
      - `type` string: The file type.
      - `url` string: A link to the thumbnail.
    - `transcript` object: Details about the meeting transcript.
      - `created_at` number: When the file was created, in seconds using the Unix timestamp format.
      - `expires_at` number: When the file will be deleted from the Nylas servers, in seconds using the Unix timestamp format.
      - `name` string: The file name.
      - `size` integer: The size of the file, in bytes.
      - `ttl` number: Seconds remaining until the file is deleted from Nylas servers. This is the difference between `expires_at` and the time when you made your request. Download URLs expire separately, 60 minutes after they're generated.
      - `type` string: The file type.
      - `url` string: A link to the meeting transcript.

## Other responses

- `207`: Multi-Status. Returns the available Notetaker media in the same format as a `200` response, and lists the enabled files that Nylas couldn't generate in `data.errors`.
- `401`: Unauthorized
- `404`: Not Found
- `410`: Gone. The requested media has been deleted after exceeding the Notetaker's retention period. The response body is a plain-text string. Re-downloading is not possible — see [Notetaker retention policies](/docs/v3/notetaker/retention-policies/) for details on configuring `retention_time`.
- `429`: Rate limited. The provider or Nylas throttled the request. If a provider throttles a request and says how long to wait, the `Retry-After` header gives that number of seconds. When the header is missing, retry with exponential backoff. See [429 rate limit errors by provider](/docs/api/errors/400-response/#429-rate-limit-errors-by-provider).

## Changes

- **2026-10-27** `6c4890f0fec2`: 1 info
  - added the success response with the status `207`
- **2026-09-26** `763d6b969cd7`: 1 info
  - added the optional property `error/provider_error` to the response with the `429` status
- **2026-09-22** `a0f9c939b823`: 1 info
  - added the non-success response with the status `410`

[Operation history](https://skmtc.dev/nylas/apis/nylas-api/changes/v3/grants/:grant_id/notetakers/:notetaker_id/media/get.md)

---

[API](https://skmtc.dev/nylas/apis/nylas-api.md) - [All operations](https://skmtc.dev/nylas/apis/nylas-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nylas/apis/nylas-api/revisions/7782a3e3ab70?raw)