---
title: "List Shared With Me"
method: GET
path: "/asset/shared_with_me"
tags: ["accepts-api-key"]
---

# List Shared With Me

`GET /asset/shared_with_me`

## 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/shared_with_me`
- Auth: none declared

List the files and folders other people shared with you, folders first.

Without ``folder_id``: everything shared with you or with one of your
groups that you do not own, except what sits inside a folder that is
itself shared with you. With ``folder_id``: that folder's contents. Rows
carry the owner's path in ``file_name``. Page with ``next_cursor``.

## Query parameters

- `limit` integer
- `folder_id` string, uuid, nullable: A folder shared with you, or inside one: list its contents. Leave out to list what was shared with you.
- `cursor` string, nullable

## Headers

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

## Response `200`

Successful Response

- SharedWithMeResponse
  - `items` FileReference[], required
    - `file_name` string, required
    - `is_folder` boolean, required
    - `file_id` string, nullable, required
    - `file_type` string, nullable, required
    - `mime_type` string, nullable
    - `duration_seconds` number, nullable
    - `last_edit` string, date-time, required
    - `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.
    - `preview_frames` PreviewFrame[], nullable
      - `asset_id` string, required
      - `frame_time` number, required
  - `next_cursor` string, nullable: Pass back as cursor for the next page; null at the end.

## Other responses

- `422`: Validation Error

---

[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)