Media Chapters

Media Chapters hold certain structures of a Media asset based on entries which can be linked to Media Sections. Every Media asset of type video or audio has an AI generated Media chapter of type autogenerated - this autogenerated Media chapter is not editable. In order to change an autogenerated Media chapter, you have to copy it. The copy has type usergenerated and is editable.

📄️ Create a media chapter

A `Media Chapter` structures a `Media` asset based on `entries` which can be linked with `Sections`.

📄️ List media chapters

List all `Media Chapters` of the `Media` asset.

📄️ Retrieve a media chapter

Retrieving a `Media Chapter` by id will load a certain structure of a `Media` asset.

📄️ Delete a media chapter

Deletes a `Media Chapter` of a `Media` asset by id. All referenced `entries` and `Sections` will be also deleted.

📄️ Update a media chapter

Update a `Media Chapter` name or description.

📄️ Copy a media chapter

Copy a `Media Chapter` will duplicate and all referenced `entries` and `Sections`.

📄️ Recalculate autogenerated media chapters

Existing structure of the autogenerated `Media Chapter` will be recreated based on the the `videoText` (OCR) and `transcript` [Metadata](#tag/Media-Metadata). Existing segment embeddings will be deleted and recalculated.

📄️ Create an entry

`Entries` are used to structure a `Media` asset and belong to a dedicated `Media Chapter`.

📄️ Bulk update entries

The endpoint can be used to update multiple `Entries` in `Media Chapter` with one request.

📄️ Update an entry

Update an entry of a `Media Chapter` can be used to change the title of the `entry`.

📄️ Delete an entry

It will delete also all child `entries` of the `Media Chapter`.

📄️ Link a section with an entry

This endpoint can be used to structure your `Media` asset. The `Section` to be linked should be created in the context of the `Media Chapter`.

📄️ Unlink a section from an entry

Removing a `Section` from an entry will make that entry a navigational element of the `Media Chapter`.