---
title: "Get Custom Agent Prompt Assets Sharing"
method: GET
path: "/agent/custom/{custom_agent_id}/share/prompt_assets"
---

# Get Custom Agent Prompt Assets Sharing

`GET /agent/custom/{custom_agent_id}/share/prompt_assets`

## 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/agent/custom/{custom_agent_id}/share/prompt_assets`
- Auth: none declared

Whether the assets the assistant's prompt names are shared with everyone
the assistant is shared with.

A run reads each prompt asset as the person running it, so someone who
cannot view one gets an assistant that cannot use it. This lists the
assets missing a person, group or pending invite of the assistant (VIEW
each), with who; ``in_sync`` is true when there are none. Needs the
assistant shared with the caller.

## Path parameters

- `custom_agent_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/agent/custom/:custom_agent_id/share/prompt_assets/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)