Media Sections

Sections can be used to structure the content of a Media asset and make it accessible. They unify the creation of markers and chapters of Media assets, through time or timeranges respectively. The timerange type is used to create the Chapters for the player timeline.

📄️ List sections

Returns a list of sections for the `Media` asset. By default, only non-linked sections are returned.

📄️ Create section

Creates a new `Section` for a `Media` asset. The `Section` can be a `marker` or a `timerange` of the `Media` asset.

📄️ Get section

Retrieves a particular `Section` for a `Media` asset based on its identifier.

📄️ Update section

Updates selected properties of a `Section`, such as its `start` or `end` time.

📄️ Delete section

Deletes a `Section` and removes its association with the `Media` asset.

📄️ Get section thumbnail

Retrieves the thumbnail of a `Media` asset `Section`, including the image URL and its dimensions.

📄️ Update section thumbnail

Updates a `Media` section's thumbnail.

📄️ Delete section thumbnail

Removes a given thumbnail from a `Media` asset `Section`.

📄️ Split section

Splits a `MediaSection` into two contiguous parts at the provided `splitAt` timestamp. Designed as a convenience method for clipping workflows, this operation ensures the original section's duration is preserved across two distinct ones. The response returns the modified original section as `updated` (changed to a `timerange` type ending at the `splitAt` point) alongside a newly generated section as `created` (inheriting the original `type` and `end` boundary, starting from the 'splitAt' point).