Create Scene

Create a scene in a project — the container for everything the pipeline produces. Run the generate_scene_* steps against it, or bring your own SDD and PEG with upload_scene_artifact. Requires the write scope.

Authorization

apiKey

AuthorizationBearer <token>

First-party API key (sbk_live_…), presented as a Bearer token.

In: header

Path Parameters

project_id*Project Id

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

A new scene — the container everything the pipeline produces lives in.

name*Name

Length1 <= length <= 120

workflow?Workflow

Pipeline family. t2s (text-to-scene) is what the API steps drive.

Default"t2s"

Value in

"t2s"
"i2s"
"s2s"

description?|null

theme_id?|null

source_file_id?|

An uploaded GLB (POST /v1/files) recorded as the scene's first model version — the starting point of an s2s scene.

Response Body

`application/json`

`application/problem+json`

curl -X POST "https://example.com/v1/projects/497f6eca-6276-4993-bfeb-53cbbbba6f08/scenes" \  -H "Content-Type: application/json" \  -d '{    "name": "string"  }'

{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "slug": "string",  "name": "string",  "description": "string",  "workflow": "string",  "status": "string",  "triangle_count": 0,  "asset_count": 0,  "created_at": "2019-08-24T14:15:22Z",  "updated_at": "2019-08-24T14:15:22Z"}