OCT-103 Gumlet outreach
GET/video/assets/{asset_id}

Get video asset details

Retrieves the details of a previously created video asset. Use the asset_id to inspect its input, output, processing status, access controls, and related playlists.

1 parameter
asset_idstringrequired

The identifier of the previously created video asset to retrieve.

5 status codes
200Returns the asset object, including its identifier, status, timestamps, input and output details, access controls, playlists, progress, and tags.
access_controlstringoptional

Access control

Allowed:privatepublicpassword-protecteddashboardOnly
access_controlsobjectoptional
asset_idstringrequired
audioOnlybooleanoptional

If true the asset is audio only

created_atintegerrequired

Asset created timestamp in milliseconds since epoch

Default:0
folderstringoptional
inputobjectoptional
outputobjectoptional
playlistsarray<string>optional

Array of Playlist IDs

processed_atintegeroptional
Default:0
progressintegeroptional
Default:0
statusstringrequired
tagarray<string>optional
thumbnail_updated_atintegeroptional

Thumbnail updated timestamp in milliseconds since epoch

updated_atintegeroptional

Asset updated timestamp in milliseconds since epoch

Default:0
video_protectionobjectoptional
warningarray<object>optional
workspace_idstringoptional

Workspace ID

workspace_updated_atintegerrequired

Collection updated timestamp in milliseconds since epoch

400Returned when the asset ID is invalid.

One documented failure

  • asset_id_not_valid

    The asset ID is not valid.

errorobjectrequired
401Returned when the request is unauthorized.

One documented failure

  • asset_not_found

    Could not find any video asset with specified asset_id.

errorobjectoptional
403Returned when the authenticated user does not have access to the asset.

One documented failure

  • access_denied

    You are not authorized to access this asset.

errorobjectrequired
404Returned when the asset is not found.

One documented failure

  • asset_not_found

    Could not find any video asset with specified asset_id.

errorobjectrequired

Error handling

A 400 is returned for an invalid asset ID, a 401 for an unauthorized request, a 403 when the authenticated user does not have access to the asset, and a 404 when the asset is not found. The asset_id path parameter must identify the asset to retrieve.