---
title: "Get Project Media Sharing"
method: GET
path: "/asset/{asset_id}/share/project_media"
---

# Get Project Media Sharing

`GET /asset/{asset_id}/share/project_media`

## Request

- Base URL: `https://api.tellers.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tellers.ai/asset/{asset_id}/share/project_media`
- Auth: none declared

Whether the media a project uses are shared like the project.

Sharing a project only lets its people view the media in it. This lists the
media on which someone the project is shared with holds less, on their own,
than their right on the project, with who and what they lack; ``in_sync``
is true when there are none. Caller must be able to view the project.

## Path parameters

- `asset_id` string, uuid, required

## Headers

- `x-api-key` string, nullable
- `authorization` string, nullable

## Response `200`

Successful Response

- MediaSharing: How the media a project or assistant uses are shared, against its own shares.
  - `in_sync` boolean, required: Everyone it is shared with holds at least the expected right on every medium it uses.
  - `can_share` boolean, required: Whether the caller may share the project or assistant.
  - `media` MediaGap[], required: The media missing someone, and who.
    - `asset_id` string, required
    - `name` string, required
    - `file_type` 'video' | 'audio' | 'image' | 'text' | 'pdf' | 'lut' | 'font' | 'placeholder' | 'group_clip' | 'master_clip' | 'aaf' | 'proj_original' | 'folder' | 'project' | 'entity' | 'teller_config'
    - `can_share` boolean, required: Whether the caller may share it.
    - `missing` MediaGrantee[], required
      - `group_id` string, nullable: Set for a group.
      - `group_name` string, nullable
      - `email` string, nullable: Set for a person, or a pending invite.
      - `pending` boolean: An invite to an email that has no account yet.
      - `right` 'ADMIN' | 'READ' | 'WRITE' | 'VIEW', required: A right on an asset, a chat or an assistant, weakest first: VIEW < READ < WRITE < ADMIN. On an asset, VIEW sees the file and everything about it except its comments, which READ adds. Chats and assistants have nothing READ adds, so VIEW opens what READ does there. Group memberships start at READ.
      - `current_right` 'ADMIN' | 'READ' | 'WRITE' | 'VIEW': A right on an asset, a chat or an assistant, weakest first: VIEW < READ < WRITE < ADMIN. On an asset, VIEW sees the file and everything about it except its comments, which READ adds. Chats and assistants have nothing READ adds, so VIEW opens what READ does there. Group memberships start at READ.
  - `lacking_for_me` MediaAccessNeed[]: The media the caller cannot read on their own, with an owner they can ask for access. Projects only; empty for assistants.
    - `asset_id` string, required
    - `name` string, required
    - `file_type` 'video' | 'audio' | 'image' | 'text' | 'pdf' | 'lut' | 'font' | 'placeholder' | 'group_clip' | 'master_clip' | 'aaf' | 'proj_original' | 'folder' | 'project' | 'entity' | 'teller_config'
    - `requested` boolean, required: A request for it is already with its owner (pending or declined), so asking again does nothing.

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-05** `fdaa0fa44a26`: 1 info
  - added the optional property `lacking_for_me` to the response with the `200` status

[Operation history](https://skmtc.dev/tellers/apis/tellers-api/changes/asset/:asset_id/share/project_media/get.md)

---

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