Nurama Developers
Assets

Create a short link for an asset

Creates a short link for an asset. If a short link already exists for the asset with the same visibility setting, the existing short link is returned. Requires `canGetAsset` on the asset.

POST
/assets/{assetId}/shortlink

Creates a short link for an asset. If a short link already exists for the asset with the same visibility setting, the existing short link is returned. Requires canGetAsset on the asset.

Authorization

AuthorizationBearer <token>

OAuth 2.1 authorization code flow with PKCE (required of every client, public or confidential). Scopes are a ceiling on the credential, not a grant of access: a token also cannot exceed what the user who approved it may already do. A write scope does not imply its matching read — ask for both.

In: header

Scope: assets:write

Path Parameters

assetId*string

ID of the asset to create a short link for.

Match^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
Formatuuid

Query Parameters

visibility?string

Optional visibility context for the short link. If specified, the deep link will include this visibility in the path. If not specified, the deep link will use the default visibility for the resource.

Value in

  • "creator"
  • "reviewer"

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/assets/497f6eca-6276-4993-bfeb-53cbbbba6f08/shortlink"
{  "code": "Ab3dEf9H",  "shortUrl": "https://app.nurama.com/s/Ab3dEf9H"}