Media

The Media asset object represents the files that have been uploaded and are hosted on the Streamdiver cloud. You can upload files using the create an upload request. We support four asset types:

• video
• audio
• image
• document

Channels can be used to organize the Media assets, each Media asset must be a part of at least one Channel.

The Metadata of an uploaded file is automatically extracted, including derived content-based metadata like transcripts. Additionally Metadata is indexed for searchability.

📄️ List media assets

The endpoint returns a list of all `Media` assets within the current authorization scope.

📄️ Bulk delete media assets

Bulk operation to delete multiple `Media` assets with one request. Per default, a soft-deletion is done, changing the status of the assets to `softDeleted`. Optionally, a hard-deletion can be requested, which means the assets are physically deleted from the storage servers.

📄️ Bulk assign tags

The endpoint can be used to assign tags to multiple `Media` assets with one request.

📄️ Get media tags

Get all and common `Tags` of given `Media` assets

📄️ Retrieve a media asset

Returns the current representation of a `Media` asset, containing detailed information about the `Media` asset, such as its `name`, `description` and for video/audio assets the playlist URL. Use optional parameter `channelId` to retrieve a `Media` asset in the context of a `Channel` for embedding purposes. Iframe embeddings will then be based on the `Channel` design options like `playerDesign`.

📄️ Update a media asset

Updates `Media` asset basic properties.

📄️ Remove a media asset

Change a `Media` asset's status status to `softDeleted` or optionally, request a hard-deletion, meaning the `Media` asset will be physically deleted from our storage.

📄️ Recover a deleted media asset

Restore a soft-deleted `Media` asset with all previous `Channel` assignments.

📄️ Retrieve a thumbnail

Retrieve the thumbnail associated with a `Media` asset. The thumbnail is a small image that represents the `Media` asset.

📄️ Update a thumbnail

Updates thumbnail for `Media` asset. <br /> Allowed image formats:

📄️ Delete a thumbnail

Delete thumbnail from the `Media` asset

📄️ Manually ingest a media asset

If an ingest fails, you can force a new ingest with this endpoint. If you re-ingest a `Media` asset that has an succesfull `ingestJob`, the renditions will be replaced.

📄️ Share a media asset

The `Media` asset is assigned to a new [Channel](#tag/Channels) with visibility level `shared`. The `Channel` will be named `Share_{mediaId}` and is created automatically in the background. The `Channel` and `Media` asset will not be shown in the Streamdiver Public Portal landing page, the asset can only be accessed by using the `shareLink` URL.

📄️ List comments

Returns list of comments under specific `Media` asset.

📄️ Create a comment

Create a new comment for a `Media` asset.

📄️ Update a comment

Updates a comment of a `Media` asset.

📄️ Delete a comment

Remove a comment of a `Media` asset.

📄️ Retrieve permissions on media asset

Retrieves a list of permissions which the current user has on the given `Media` asset. `SuperAdmins` have all available permissions, the permissions of all other users are based on the respective `ChannelMemberships` and `ChannelRoles`.

📄️ List media assets of a channel

Retrieve all `Media` assets assigned to a `Channel`.

📄️ Get structured data for SEO

Provides the structured metadata in `JSON/LD` format to use for SEO enhancement when embedding the `Media` asset. The structured-data schema is consistent with the Google SEO standard for videos ([Video structured data](https://developers.google.com/search/docs/appearance/structured-data/video)).