---
title: "Update a user private scene"
method: PUT
path: "/v1/scenes/{id}"
tags: ["Scenes"]
---

# Update a user private scene

`PUT /v1/scenes/{id}`

## Path parameters

- `id` string, required

## Request body

- UpdateSceneDto
  - `name` string
  - `description` string
  - `contextPrompt` string
  - `coverImage` string
  - `genre` string

## Response `200`

Scene updated 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

## Other responses

- `403` — You can only update your own scenes
- `404` — Scene not found

---

[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)