Cubicle

List snapshots to create Boxes from

GET
/v1/orgs/{org}/snapshots

Returns the complete snapshots in {org} that the caller may create a Box from, as a bare array sorted by source Box name and then newest first. Owners and admins see every one; members see only snapshots of Boxes they hold a grant on. Snapshots of deleted Boxes are not listed.

Each entry names its source Box, the Node that holds it and the size a Box created from it gets by default. Any active member may call this route; API keys may list only their own organization.

See Snapshots.

Authorization

headerAuthorizationBearer <token>

A service account API key (cbk_…), used directly as the bearer token. read keys may call only GET routes.

Path Parameters

org*string

The organization's name or ID.

Response Body

Snapshots the caller may create Boxes from.

application/json
  1. response
[index: integer]?

Completed snapshots the requester may use to create a Box in this organization.

Example Request
curl -X GET 'https://api.cubicle.sh/v1/orgs/acme/snapshots'
Example Response
[  {    "id": "5a7c9e1b-3d5f-4a6b-8c0d-2e4f6a8b0c3d",    "name": "before-upgrade",    "createdAt": "2026-11-05T10:20:00.000Z",    "box": {      "id": "0f6c2a5e-3b1d-4c8e-9a7f-2d4e6b8c1a3f",      "name": "job-1"    },    "node": {      "id": "c3a9e1f7-5b2d-4a8c-8e6f-0d1b3c5e7a9f",      "name": "node-1"    },    "spec": {      "vcpus": 2,      "memoryMiB": 2048,      "diskGiB": 12    }  }]