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 media chapter

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

📄️ List media chapters

Lists all `Media Chapter`s of the `Media` asset.

📄️ Import a media chapter

Import a `Media Chapter` via OParl interface.

📄️ Get media chapter

Retrieves the structure of a `Media` asset by loading a `Media Chapter` by its identifier.

📄️ Delete media chapter

Deletes a `Media Chapter` of a `Media` asset by its identifier. All referenced `entries` and `Section`s will also be deleted.

📄️ Update media chapter

Updates a `Media Chapter`'s name or description.

📄️ Copy a media chapter

Copies a `Media Chapter`, duplicating it and all referenced `entries` and `Section`s.

📄️ Recalculate autogenerated media chapters

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

📄️ Create entry

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

📄️ Bulk update entries

Updates multiple `Entry` objects in a `Media Chapter` with a single request.

📄️ Update entry

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

📄️ Delete entry

Deletes an entry and all its child `entries` from the `Media Chapter`.

📄️ Link a section with an entry

Links a `Section` to an `entry` to structure a `Media` asset. The `Section` to be linked must be created in the context of the `Media Chapter`.

📄️ Unlink a section from an entry

Removes a `Section` from an entry, making that entry a navigational element of the `Media Chapter`.