List all scenes

Your workspace's scenes, newest first, with the surfaces found in each.

GEThttps://www.skipshoot.com/api/v1/scenes

Updated October 28, 2026

On this page

Request
Response
Errors

Every scene in your workspace that has a picture, newest first: rooms added through the API, and rooms uploaded or built in the app. Each scene’s origin says which.

Request

No parameters. The whole list comes back in one response.

Response

scenes: a list of Scene objects. A scene’s surfaces are listed only once its status is ready.

Errors

Status	Type	When
401	`authentication_required`	No key was sent.
401	`invalid_api_key`	The key is not valid or was revoked.
403	`key_kind_not_allowed`	A publishable key was sent.
429	`rate_limited`	Too many requests this minute.

Request

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

Response

{
  "scenes": [
    {
      "id": 815,
      "name": "Back patio",
      "origin": "upload",
      "setting": "outdoor",
      "status": "analyzing",
      "image_url": "https://…",
      "surfaces": [],
      "created_at": "2026-10-21T15:10:05.000Z"
    },
    {
      "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.