---
title: "Update Highlight Video"
method: PUT
path: "/v1/videos/{video_id}/highlights"
tags: ["Video Emotion API"]
---

# Update Highlight Video

`PUT /v1/videos/{video_id}/highlights`

Generate custom highlight video using user-defined time segments.

Creates a highlight reel by concatenating specific video segments chosen by the user.
The process runs asynchronously via Celery workers to handle video processing.

Args:
    video_id: The unique video ID for which highlights are being generated
    segments: List of time segments with start_millis and end_millis timestamps
    user_info: Authenticated user information

Returns:
    HighlightGenerateResponse: Contains video_id, status="queue", and processing message
    
Raises:
    InvalidParams: If segments list is empty
    InvalidUser: If user doesn't own the video
    UserVideoException: If segment timestamps are invalid:
        - Both start and end are 0
        - Start equals end
        - Start is greater than or equal to end
        - Timestamps are out of video duration bounds
    CreditExpired: If user has insufficient credits
    VideoNotFound: If video doesn't exist or is not completed

Credit Usage:
    10 credits per minute of video duration.
    Professional and Enterprise plans: 5 credits per minute.

## Path parameters

- `video_id` string, required — The unique video id of the video for which the update highlight video to be edited.

## Request body

- SegmentResponse[] — List of video highlight segments
  - `start_millis` number, required
  - `end_millis` number, required

## Response `200`

Successful Response

- HighlightGenerateResponse — Model for highlight video generation trigger response. Attributes: video_id (str): The video ID for which highlights are being generated. message (str): Status message about the highlight generation process. status (str): Current status of highlight generation (queue, processing, completed, failed).
  - `video_id` string, required
  - `message` string, required
  - `status` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/imentiv/apis/welcome-to-imentiv-ai.md) · [All operations](https://skmtc.net/imentiv/apis/welcome-to-imentiv-ai/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/imentiv/welcome-to-imentiv-ai/revisions/4a61d1ac9025/schema)