---
title: "Create a new private scene"
method: POST
path: "/v1/scenes"
tags: ["Scenes"]
---

# Create a new private scene

`POST /v1/scenes`

## Request body

- CreateSceneDto
  - `name` string, required
  - `description` string, required
  - `contextPrompt` string, required
  - `coverImage` string
  - `genre` string

## Response `201`

Scene created successfully

- SceneDto
  - `id` string, required
  - `name` string, required
  - `description` string, required
  - `coverImage` string
  - `avatarUrl` string — CDN URL of the scene avatar icon
  - `genre` string
  - `isPublic` boolean, required
  - `status` 'DRAFT' | 'IN_QUEUE' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' | 'CANCELLED' | 'TIMED_OUT', required — Current status of the scene
  - `isNew` boolean, required — Whether the scene was created within the last 30 days
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

---

[API](https://skmtc.dev/miaai/apis/backend-template-api.md) · [All operations](https://skmtc.dev/miaai/apis/backend-template-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/miaai/backend-template-api/revisions/2a8d88a5124f/schema)