---
title: "List shareable assets"
method: GET
path: "/share"
tags: ["Share"]
---

# List shareable assets

`GET /share`

## Request

- Base URL: `https://api.cloudglue.dev/v1`
- URL: `https://api.cloudglue.dev/v1/share`
- Auth: HTTP bearer

List shareable assets

## Query parameters

- `file_id` string, uuid
- `file_segment_id` string, uuid
- `limit` integer
- `offset` integer
- `created_before` string, date
- `created_after` string, date
- `visibility` 'public' | 'private'

## Response `200`

Shareable assets listed successfully

- ShareableAssetListResponse
  - `object` 'list', required: Object type, always 'list'
  - `data` ShareableAsset[], required
    - `id` string, uuid, required: The unique identifier of the shareable asset
    - `file_id` string, uuid, required: The ID of the file the shareable asset belongs to
    - `file_segment_id` string, uuid: The ID of the file segment the shareable asset belongs to (optional)
    - `title` string: The title of the shareable asset
    - `description` string: The description of the shareable asset
    - `metadata` object: The metadata of the shareable asset
    - `visibility` 'public' | 'private': The visibility of the shareable asset. 'public' assets are viewable by anyone with the link; 'private' assets are restricted to members of the owning account and stream via a signed, token-gated playback url.
    - `link_preview` 'none' | 'full' | 'player', required: Controls rich link-preview (Open Graph) metadata for unfurl bots on private shares. 'none' (default) emits no preview metadata; 'full' emits title, description, and thumbnail; 'player' additionally lets the share play inline when its link is unfurled by the Cloudglue Slack app — anyone who can see the Slack message can play it. Public shares always emit full metadata (and unfurl playable where the Slack app is installed) regardless of this value.
    - `preview_url` string: The thumbnail url of the shareable asset
    - `media_download_url` string: The signed media download url of the shareable asset. For private assets this url is short-lived (a few minutes) and should be used promptly.
    - `media_download_expires_at` number, nullable: The timestamp of when the media download url will expire
    - `share_url` string: This is the url that can be used to share the shareable asset. For private assets the page requires sign-in and membership of the owning account.
    - `stream_url` string: The HLS stream url of the shareable asset. Available when the stream has finished processing. For private assets this is a signed, token-gated url that should be treated as short-lived. When the asset was fetched with a clip window (clip_start/clip_end on GET /share/{id}), the stream plays only that window.
    - `status` 'pending' | 'processing' | 'completed' | 'failed': The status of the shareable asset
    - `asset_type` 'file' | 'file_segment': The type of asset the shareable asset belongs to
    - `created_at` number, required: The timestamp of when the shareable asset was created
    - `object` 'share': Object type, always 'share'
  - `total` integer, required: The total number of items
  - `limit` integer, required: The number of items per page
  - `offset` integer, required: The offset of the items

## Changes

- **2026-08-12** `725b9736a231`: 1 warning
  - added the new `player` enum value to the `data/items/link_preview` response property for the response status `200`
- **2026-07-19** `42caafb55f9f`: 1 info
  - added the required property `data/items/link_preview` to the response with the `200` status
- **2026-06-04** `a100e95d54ba`: 2 info
  - added the new optional `query` request parameter `visibility`
  - added the optional property `data/items/visibility` to the response with the `200` status
- **2026-03-11** `1d5d6115c0d0`: 2 breaking
  - for the `query` request parameter `limit`, default value `50` was removed
  - for the `query` request parameter `offset`, default value `0` was removed
- **2026-02-26** `8c51909240f6`: 1 info
  - added the optional property `data/items/stream_url` to the response with the `200` status

[Operation history](https://skmtc.dev/cloudglue/apis/cloudglue-api/changes/share/get.md)

---

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