Enable video chapters on a media | FastPix Developer Documentation

This endpoint will be deprecated on September 30, 2026. To generate chapters for an existing media, use Generate video chapters instead.

This endpoint enables you to generate chapters for an existing media file.

How it works

Make a PATCH request to this endpoint, replacing <mediaId> with the ID of the media for which you want to generate chapters.
Include the chapters parameter in the request body to enable.
The response contains the updated media data, confirming the changes made.

You can use the video.mediaAI.chapters.ready webhook event to track and notify about the chapters generation.

Use case: This is particularly useful when a user uploads a video and later decides to enable chapters without re-uploading the entire video.

Related guide: Video chapters

<Callout intent="warning"> This endpoint will be deprecated on September 30, 2026. To generate chapters for an existing media, use [Generate video chapters](/in-video-ai-api/video-chapters/create-ai-chapters) instead. </Callout> This endpoint enables you to generate chapters for an existing media file. #### How it works 1. Make a `PATCH` request to this endpoint, replacing `<mediaId>` with the ID of the media for which you want to generate chapters. 2. Include the `chapters` parameter in the request body to enable. 3. The response contains the updated media data, confirming the changes made. You can use the <a href="https://fastpix.com/docs/webhooks/in-video-ai-events#videomediaaichaptersready">video.mediaAI.chapters.ready</a> webhook event to track and notify about the chapters generation. **Use case:** This is particularly useful when a user uploads a video and later decides to enable chapters without re-uploading the entire video. Related guide: <a href="https://fastpix.com/docs/in-video-ai/generate-video-chapters">Video chapters</a>

Authentication

AuthorizationBasic

FastPix APIs are secured with Basic Authentication. Use your Access Token ID as the username and Secret Key as the password in the Authorization header of each API request.

Username: Access Token ID
Password: Secret Key

Activate your FastPix account to generate your API credentials. See the guide here

FastPix APIs are secured with Basic Authentication. Use your Access Token ID as the username and Secret Key as the password in the Authorization header of each API request. - <b>Username:</b> Access Token ID - <b>Password:</b> Secret Key Activate your FastPix account to generate your API credentials. <a href="https://fastpix.com/docs/getting-started/activate-your-account" target="_blank">See the guide here</a>

Path parameters

mediaIdstringRequiredformat: "uuid"

The unique identifier assigned to the media when created. The value must be a valid UUID.

Request

This endpoint expects an object.

chaptersbooleanRequiredDefaults to true

Enable or disable the chapters feature for the media. Set to true to enable chapters or false to disable.

Response

Media details updated successfully with the chapters feature enabled or disabled

successbooleanOptional

Shows the request status. Returns true for success and false for failure.

dataobjectOptional

This endpoint will be deprecated on September 30, 2026. To generate chapters for an existing media, use Generate video chapters instead.

This endpoint enables you to generate chapters for an existing media file.

How it works

Make a PATCH request to this endpoint, replacing <mediaId> with the ID of the media for which you want to generate chapters.
Include the chapters parameter in the request body to enable.
The response contains the updated media data, confirming the changes made.

You can use the video.mediaAI.chapters.ready webhook event to track and notify about the chapters generation.

Use case: This is particularly useful when a user uploads a video and later decides to enable chapters without re-uploading the entire video.

Related guide: Video chapters