---
title: "Create Highlight Package"
method: POST
path: "/v1/highlight-packages"
tags: ["Highlight Packages"]
---

# Create Highlight Package

`POST /v1/highlight-packages`

## Request body

- CreateMultiGamePackageRequest
  - `name` string, nullable
  - `project_ids` integer[], required
  - `target_duration_seconds` integer, required
  - `editorial_prompt` string, nullable
  - `team_filter` string[], nullable
  - `player_filter` string[], nullable
  - `event_type_filter` string[], nullable
  - `fight_filter` ProjectFightFilter[], nullable
    - `project_id` integer, required
    - `fight_numbers` integer[], required
  - `selected_fights` ProjectFightFilter[], nullable
    - `project_id` integer, required
    - `fight_numbers` integer[], required
  - `selected_edit_ids` string[], nullable
  - `sport` string, nullable
  - `recap_options` RecapOptions
    - `start_style` 'none' | 'short_walkout' | 'full_walkout', nullable
    - `ending_style` 'auto' | 'decision_or_ending', nullable
    - `pacing` 'tight_action' | 'balanced' | 'action_sprint', nullable
    - `editorial_prompt` string, nullable
    - `duration_mode` 'exact' | 'range' | 'uncapped', nullable
    - `target_duration_min_seconds` integer, nullable
    - `target_duration_max_seconds` integer, nullable
  - `render_video` 'ffmpeg' | 'none'

## Response `200`

Success

- CreateMultiGamePackageResponse
  - `id` integer, required
  - `status` string
  - `task_id` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/narrative-sports/apis/narrative-sports-api.md) · [All operations](https://skmtc.net/narrative-sports/apis/narrative-sports-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/narrative-sports/narrative-sports-api/revisions/86b5690d9e38/schema)