Retrieve a scene

One scene: its status and, once it is ready, its surfaces.

GEThttps://www.skipshoot.com/api/v1/scenes/{id}

Updated October 28, 2026

On this page

Request
Response
Errors

Poll this after Create a scene until the status is ready or failed. A scene always reaches one of the two, so polling it always ends.

Request

idinteger, pathrequired: The scene’s id.

Response

scene: a Scene. Once it is ready, surfaces lists what a render can go on; pass a surface’s id as surface_id to choose it.

Errors

Status	Type	When
404	`not_found`	No scene with that id in your workspace.
429	`rate_limited`	Too many requests this minute. Poll less often.

Request

curl https://www.skipshoot.com/api/v1/scenes/812 \
  -H "Authorization: Bearer $SKIPSHOOT_SECRET_KEY"

Response

{
  "scene": {
    "id": 812,
    "name": "Library",
    "origin": "upload",
    "setting": "indoor",
    "status": "ready",
    "image_url": "https://…",
    "surfaces": [
      {
        "id": "wall_1",
        "name": "Back wall",
        "type": "wall"
      },
      {
        "id": "floor_1",
        "name": "Floor",
        "type": "floor"
      },
      {
        "id": "sofa_1",
        "name": "Sofa",
        "type": "furniture"
      },
      {
        "id": "scene_lighting",
        "name": "Scene lighting",
        "type": "lighting"
      }
    ],
    "created_at": "2026-10-21T14:02:40.000Z"
  }
}

Something these pages do not answer? Email admin@skipshoot.com and we’ll help.