Nurama Developers
Namespaces

shortlink

Methods and types of the `shortlink` namespace (`client.shortlink` / `bot.shortlink`).

Interfaces

PublicDownloadUrlResponse

Properties

PropertyType
expiresnumber
fileNamestring
mimeTypestring
urlstring

PublicEmbedFilesResponse

Properties

PropertyTypeDescription
fileNamestring-
mediaKeyPathstring | nullOriginal media keyPath used as fallback when no HLS manifest is available.
mediaTypestring-
mode?"embed" | "embed-download"Mode of the underlying public link: 'embed' (no download) or 'embed-download' (download allowed alongside embed). 'download' never appears — that mode blocks the embed-files endpoint entirely. Optional for backward compatibility with older API versions; treat absence as 'embed-download'.
posterKeyPathstring | nullPoster image keyPath for video assets (explicit poster, falling back to largest thumbnail). Null when none exists.
streamKeyPathstring | nullHLS manifest keyPath (e.g. "workspaces/.../stream/index.m3u8"), null if not yet processed.
waveformKeyPath?string | nullPre-computed waveform peaks JSON keyPath for audio assets. Null for video / when no peaks file exists.

ResolvePublicDownloadResponse

Properties

PropertyTypeDescription
fileNamestring-
mediaTypestring-
mimeType?string | nullMime type of the original media file, when known.
mode?"download" | "embed" | "embed-download"Capability mode of the link. The download page uses this to decide whether to render the inline preview (embed-download), the embed-only message (embed), or auto-download (download). Optional for backward compatibility with older API versions; treat absence as embed-download.
previewKeyPath?string | nullFor image assets: the keyPath of the image file, used to render an inline preview on the download page. Null for non-image assets (video / audio previews are iframed from the embed page; files render an icon).
statusstring-
tokenstring-

ResolveShortLinkResponse

Properties

PropertyType
deepLinkstring
resourceIdstring
resourceType"asset" | "project" | "workspace" | "chatMessage" | "chatSubmission"
visibility"creator" | "reviewer" | null

Functions

default()

function default(client): {
  resolveShortLink: Promise<ResolveShortLinkResponse>;
};

Defines short link related methods for the NuramaClient.

Parameters

ParameterTypeDescription
clientdefaultThe NuramaClient instance.

Returns

An object containing the short link related methods.

NameTypeDescription
resolveShortLink()(code) => Promise<ResolveShortLinkResponse>Resolves a short link code to its full deep link path. This endpoint is publicly accessible and does not require authentication.

On this page