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

## Request

- Base URL: `https://api.brandbooster.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brandbooster.ai/api/v1/ai-video-storyboard/edit-reference-sheet`
- Auth: HTTP bearer

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/brandbooster-api.md) - [All operations](https://skmtc.dev/brandbooster/apis/brandbooster-api/llms.txt) - [OpenAPI document](https://skmtc.dev/brandbooster/apis/brandbooster-api/revisions/f84fc05f417b?raw)