---
title: "Create Recap"
method: POST
path: "/v1/recaps"
tags: ["Recaps"]
---

# Create Recap

`POST /v1/recaps`

## Request body

- CreatePublicRecapRequest
  - `name` string, nullable
  - `project_id` integer, required
  - `target_duration_seconds` integer, required
  - `exclude_event_types` string[], nullable
  - `selected_edit_ids` string[], nullable
  - `recap_mode` string
  - `fight_ceremony_config` FightCeremonyConfig[], nullable
    - `fight_number` integer, required
    - `include_walkon` boolean
    - `include_decision` boolean
  - `render_video` 'ffmpeg' | 'none'
  - `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

## Response `200`

Success

- CreatePublicRecapResponse
  - `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)