---
title: "Create"
method: POST
path: "/api/v1/remy/storyboards"
tags: ["remy-storyboards"]
---

# Create

`POST /api/v1/remy/storyboards`

## 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/remy/storyboards`
- Auth: HTTP bearer

## Request body

- CreateStoryboardDTO
  - `id` string, uuid, required
  - `order_id` string, uuid, nullable
  - `creator_id` string, uuid, nullable
  - `catalog_creator_id` string, uuid, nullable
  - `campaign_id` string, uuid, required
  - `domain_id` string, uuid, required
  - `title` string, required
  - `source_kind` 'brief' | 'script' | 'upload', required
  - `source_text` string
  - `source_filename` string, nullable
  - `source_document_key` string, nullable
  - `duration` integer
  - `aspect_ratio` '9:16' | '16:9' | '1:1'

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

> 35 revisions in range; 1 not diffed.

- **2026-09-28** `461ae7e5d079`: 5 info
  - added the new optional request property `source_document_key`
  - the request property `source_text` became optional
  - the `source_text` request property default value `` was added
  - added the new `upload` enum value to the request property `source_kind`
  - …1 more
- **2026-09-21** `a6cea1834b97`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/brandbooster/apis/fastapi/changes/api/v1/remy/storyboards/post.md)

---

[API](https://skmtc.dev/brandbooster/apis/fastapi.md) - [All operations](https://skmtc.dev/brandbooster/apis/fastapi/llms.txt) - [OpenAPI document](https://skmtc.dev/brandbooster/apis/fastapi/revisions/8e8c18c2dc35?raw)