# 插入新场景 (/zh-CN/api-reference/api-ref/whiteboard/restful/insert-scenes) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 插入新场景。 - OpenAPI: /openapi/whiteboard/restful-wb.zh-CN.yaml - Operation ID: post-v5-rooms-uuid-scenes - Method: POST - Path: /v5/rooms/{uuid}/scenes - Endpoint: https://api.netless.link/v5/rooms/{uuid}/scenes ## Servers - https://api.netless.link ## Parameters - `region` (header, required, string) - 指定处理该请求的数据中心,取值如下: - `cn-hz`:中国杭州,服务区覆盖中国大陆地区及其他数据中心未覆盖的区域。 - `us-sv`:美国硅谷,服务区覆盖北美洲、南美洲。 - `sg`:新加坡,服务区覆盖新加坡、东亚、东南亚。 - `in-mum`:印度孟买,服务区覆盖印度。 - `eu`:欧洲(法兰克福),服务区覆盖欧洲。 - Allowed: `cn-hz` | `us-sv` | `sg` | `in-mum` | `eu` - `token` (header, required, string) - SDK Token,可以通过以下方式获取: - 在声网控制台生成用于测试的 SDK Token,详见[获取互动白板项目的安全密钥](/zh-CN/realtime-media/whiteboard/fastboard-sdk/build/setup-and-access/enable-service#获取互动白板项目的安全密钥)。 - 调用服务端 RESTful API, 详见[生成 SDK Token](generate-sdk-token)。 - 在 App 服务端用代码生成,详见[在 App 服务端生成 Token](/zh-CN/realtime-media/whiteboard/fastboard-sdk/build/setup-and-access/generate-token#在-app-服务端生成-token)。 - `uuid` (path, required, string) - 房间的 UUID, 即房间的全局唯一标识符,可通过调用[创建房间 API](create-room) 或[获取房间信息 API](get-room) 获取。 ## Request body - `scenes` (array, required) - 由场景组成的数组。 - `scenes.items` (object) - `scenes.items.name` (string, required) - 场景名称,不能与所属场景组下的其他场景重名,不能包含 `/`。 - `scenes.items.ppt` (object, required) - 场景背景图的属性。 - `scenes.items.ppt.src` (string) - 图片的 URL。 > [!CAUTION] > 请确保你的浏览器可以访问并支持展示该图片,否则,该图片可能无法显示在白板场景中。 - `scenes.items.ppt.width` (number) - 图片的宽度,单位像素。 - `scenes.items.ppt.height` (number) - 图片的高度,单位像素。 - `path` (string, required) - 场景组的地址。 > [!NOTE] > 如果传入的场景组地址已经存在,则在已有的场景组下插入指定的新场景;如果传入的场景组地址不存在,则自动新建一个场景组并在该场景组下插入指定的新场景。 ### Request body example ```json { "scenes": [ { "name": "page1", "ppt": { "src": "xxxx", "width": 640, "height": 360 } }, { "name": "page2", "ppt": { "src": "xxxx", "width": 640, "height": 360 } } ], "path": "/test" } ``` ## Responses ### 201 若返回的状态码为 `201` 则表示请求成功。响应 Body 为空对象。 若返回的状态码不为 `201` 则表示请求失败。你可以参考[响应状态码](/zh-CN/realtime-media/whiteboard/fastboard-sdk/reference/response-code)了解可能的原因。 No schema. ## Response examples ### 201 ```json {} ```