Get asset

Read one uploaded asset with a fresh signed download link.

GEThttps://api.tried.com.au/get-asset/{asset_id}

Returns one asset. Call it whenever you need a download link, since each url expires 1 hour after it is issued.

Request#

Path parameter	Type	Description
`asset_id`	string	The asset ID, for example `asset_3c8e1a5f7b9d2e4a6c0f1b3d`.

Example request#

curl https://api.tried.com.au/get-asset/asset_3c8e1a5f7b9d2e4a6c0f1b3d \
  -H "Authorization: Bearer $TRIED_API_KEY"

const res = await fetch(
  "https://api.tried.com.au/get-asset/asset_3c8e1a5f7b9d2e4a6c0f1b3d",
  { headers: { Authorization: `Bearer ${process.env.TRIED_API_KEY}` } },
);
const asset = await res.json();

import os, requests

res = requests.get(
    "https://api.tried.com.au/get-asset/asset_3c8e1a5f7b9d2e4a6c0f1b3d",
    headers={"Authorization": f"Bearer {os.environ['TRIED_API_KEY']}"},
)
asset = res.json()

Response#

200 OK

{
  "asset_id": "asset_3c8e1a5f7b9d2e4a6c0f1b3d",
  "name": "Hold music",
  "kind": "hold_music",
  "mime_type": "audio/mpeg",
  "size_bytes": 1843200,
  "url": "https://api.tried.com.au/public/assets/asset_3c8e1a5f7b9d2e4a6c0f1b3d?exp=1760922000000&sig=8f2c4e6a1b3d5f7a9c0e2b4d6f8a1c3e5b7d9f0a2c4e6b8d1f3a5c7e9b0d2f4a",
  "created_timestamp": 1760918400000
}

The fields are described on Create asset.

Errors#

Status	When
`401`	Missing or invalid API key.
`403`	The key's IP allowlist or scopes reject the request. This route needs the `admin` scope.
`404`	`Asset asset_3c8e1a5f7b9d2e4a6c0f1b3d not found` in this workspace.
`429`	Rate limit exceeded. See Rate limits.

See Errors for the body format.