---
title: "Delete a scene"
method: DELETE
path: "/projects/{id}/scenes/{sceneId}"
tags: ["Scenes"]
---

# Delete a scene

`DELETE /projects/{id}/scenes/{sceneId}`

## Request

- Base URL: `https://api.livereacting.com/v1/external`
- URL: `https://api.livereacting.com/v1/external/projects/{id}/scenes/{sceneId}`
- Auth: HTTP bearer

Delete a scene from the project.

**Behavior:**
- Cannot delete the last scene
- Non-pinned layers in the scene are deleted
- Layers referencing this scene as `nextScene` are cleared
- If deleted scene was active, first remaining scene becomes active

## Path parameters

- `id` string, required
- `sceneId` string, required

## Response `200`

Scene deleted successfully

- object
  - `deletedSceneId` string
  - `synced` boolean: Whether the deletion reached a LIVE or PREPARING stream (auto-sync on)
  - `warning` object, nullable: Present if nextScene references were cleared
    - `message` string
    - `affectedLayers` object[]
      - `layerId` string
      - `sceneId` string
      - `sceneName` string

## Other responses

- `400`: Cannot delete last scene
- `401`: Authentication failed
- `404`: Project or scene not found
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/livereacting/apis/livereacting-api.md) · [All operations](https://skmtc.dev/livereacting/apis/livereacting-api/llms.txt) · [OpenAPI document](https://skmtc.dev/livereacting/apis/livereacting-api/revisions/17a9f1677fbf?raw)