---
title: "Edit Reference Sheet Endpoint"
method: POST
path: "/api/v1/ai-video-storyboard/edit-reference-sheet"
tags: ["aiVideoAdStoryBoard"]
---

# Edit Reference Sheet Endpoint

`POST /api/v1/ai-video-storyboard/edit-reference-sheet`

Apply a free-text edit to a generated reference sheet as a background
task (image-to-image; only the requested change is applied). Returns a
``task_id``; poll ``GET /ai-video-storyboard/task-status/{task_id}`` —
the ``sheet_url`` lives in ``response`` once ``status == "Completed"``.

## Request body

- EditReferenceSheetRequestDTO — Apply a free-text edit to a generated reference sheet (image-to-image via GPT Image 2 with the current sheet as the reference). Only the requested change is applied; layout, angles, and identity are preserved.
  - `image_url` string, required
  - `prompt` string, required
  - `aspect_ratio` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/brandbooster/apis/fastapi.md) · [All operations](https://skmtc.dev/brandbooster/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/brandbooster/fastapi/revisions/a9374f6fe96c/schema)