Skip to main content
GET
Get a shareable asset

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string<uuid>
required

The ID of the shareable asset to retrieve

Query Parameters

clip_start
number

Instant-clip window start in seconds. Must be provided together with clip_end. When set, the returned stream_url plays only the [clip_start, clip_end] window — the share itself is untouched, and reads without the params keep returning the full-asset stream.

Required range: x >= 0
clip_end
number

Instant-clip window end in seconds; must be greater than clip_start. Must be provided together with clip_start.

Required range: x > 0

Response

Shareable asset retrieved successfully

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

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.

Available options:
none,
full,
player
created_at
number
required

The timestamp of when the shareable asset was created

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
enum<string>

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.

Available options:
public,
private
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 | null

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
enum<string>

The status of the shareable asset

Available options:
pending,
processing,
completed,
failed
asset_type
enum<string>

The type of asset the shareable asset belongs to

Available options:
file,
file_segment
object
enum<string>

Object type, always 'share'

Available options:
share