# POST /scene

> Talos 0.6 · Since 0.6

Switch the running world to another scene of the project.

## Request

#### Request body: `SceneRequest`

`POST /scene` request: switch the running world to another scene of the project.

| Field | Type | Required | Description |
|---|---|---|---|
| `scene` | `string` | yes | The scene, project-relative with `/` separators: what `ctx.session.loadScene` takes. It is resolved inside the session's content root and may not leave it. |

## Response

#### Response: `SceneResponse`

`POST /scene` response.

| Field | Type | Present | Description |
|---|---|---|---|
| `scene` | `string` | always | The scene now running, as `ctx.session.scene()` answers it. |
| `frame` | `integer` | always | The frame the new world starts on. |
| `entities` | `integer` | always | How many entities it holds. |

## Example

```sh
curl -X POST "http://127.0.0.1:7700/scene" --json @body.json
```

Start a server with `argus run --serve`; the port is `--port` (7700 by default). The request and response fields are in the query API guide.
