---
title: "Create scene with auto-switch wiring"
method: POST
path: "/projects/{id}/workflows/create-scene-with-autoswitch"
tags: ["Workflows"]
---

# Create scene with auto-switch wiring

`POST /projects/{id}/workflows/create-scene-with-autoswitch`

## Request

- Base URL: `https://api.livereacting.com/v1/external`
- URL: `https://api.livereacting.com/v1/external/projects/{id}/workflows/create-scene-with-autoswitch`
- Auth: HTTP bearer

Creates a new scene with a video playlist layer and automatically wires
it into an existing scene sequence. The previous scene's first video
playlist layer will be updated to switch to this new scene when its
playlist completes.

This is a workflow endpoint that orchestrates:
1. Creating a new scene
2. Creating a video playlist layer in that scene
3. Updating the previous scene's layer to auto-switch to the new scene

## Path parameters

- `id` string, required

## Request body

- object
  - `sceneName` string, required: Name for the new scene
  - `previousSceneId` string, required: ID of the scene whose first video playlist layer will auto-switch to the new scene
  - `layer` object, required: Video playlist layer configuration
    - `name` string
    - `settings` object
      - `files` object[], required
        - `fileId` string, required
        - `name` string
      - `volume` number
      - `nextScene` string, nullable
      - `adPlaceholder` object, nullable: Ad placeholder video shown during ad breaks
        - `enabled` boolean
        - `fileId` string: Video file ID (required when enabled)

## Response `201`

Scene created with auto-switch wiring

- object
  - `scene` object
    - `id` string
    - `name` string
    - `isActive` boolean
  - `layer` object: Created video playlist layer
  - `autoSwitch` object
    - `previousScene` object
      - `sceneId` string
      - `sceneName` string
      - `layerId` string
      - `layerName` string
    - `nextScene` object, nullable
  - `synced` boolean: Whether changes were synced to live stream

## Other responses

- `400`: Validation error or limit reached
- `401`: Authentication failed
- `404`: Project, scene, or file not found
- `409`: Previous layer was modified or deleted during operation
- `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)