Get asset media and transcript

Returns the media type and available signed URLs for an asset, including its content, thumbnail, and transcript.

Prerequisites

Authentication and setup: A valid access token.
List published assets in a hub: Get the asset ID to look up.

Endpoint

POST /api/assethub/v1/assetmedia/{asset_id}

Base URL: the API3 REST host for your region. See Base URLs.

Headers: Authorization: Bearer ACCESS_TOKEN, Content-Type: application/json.

Path parameters

Parameter	Type	Description
`asset_id`	string	ID of the asset whose media and transcript you want.

Request

No body or query parameters. Only a valid asset_id in the URL path.

Response

Field	Type	Description
`asset_id`	string	Asset unique identifier.
`title`	string	Asset name.
`thumbnail_url`	string	URL for the asset’s thumbnail.
`raw_content_url`	string	Signed URL for raw content.
`transcript_url`	string	Signed URL for the transcript when available. See Transcript availability.
`asset_type`	string	The asset media type, for example `MEDIA_TYPE_VIDEO`. Media categories include Audio, DOC, Embedded Link, Image, PDF, Play, PPT, Video, and XLS. The example below shows the API value for Video.

Response example

{
  "asset_id": "123456789012345101",
  "title": "Test title",
  "thumbnail_url": "https://cdn.example.com/assets/asset-001/thumbnail.png",
  "raw_content_url": "https://cdn.example.com/assets/asset-001/recording.mov",
  "transcript_url": "https://cdn.example.com/assets/asset-001/transcript.json",
  "asset_type": "MEDIA_TYPE_VIDEO"
}

Notes

Behavior: The thumbnail, raw content, and transcript URLs are time-bound and signed. They expire after 30 days.
Validation: Invalid asset IDs return a 404 Not Found or 400 Bad Request error.
Transcript availability: Transcripts are unavailable for Image, Embedded Link, and Play assets. Check whether transcript_url is present in the response. Confirm transcript support for the media types your integration uses with Mindtickle Support before relying on it.