Cubicle

List an organization's Boxes

GET
/v1/orgs/{org}/boxes

Returns every Box in {org}, oldest first, as a bare array. Any active member of the organization may list them, with or without grants; API keys may list only their own organization.

A Box being deleted stays in this list with deletion: "pending" until its Node has removed it and released its resources. This list shows when a deletion has finished; Get a Box returns 404 as soon as the delete is accepted. See Deleting a Box.

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

The organization's Boxes.

application/json
  1. response
[index: integer]?
Example Request
curl -X GET 'https://api.cubicle.sh/v1/orgs/acme/boxes'
Example Response
[  {    "storage": {      "enabled": true,      "status": "base",      "checkpointId": null,      "checkpointAt": null,      "current": false,      "processedBytes": 0,      "totalBytes": 0,      "error": null,      "retryAt": null    },    "id": "0f6c2a5e-3b1d-4c8e-9a7f-2d4e6b8c1a3f",    "org": {      "id": "6b1f3d2a-8c4e-4f7a-9b2d-1e5c7a9f3b6d",      "name": "acme"    },    "name": "job-1",    "baseImage": "default",    "node": {      "id": "c3a9e1f7-5b2d-4a8c-8e6f-0d1b3c5e7a9f",      "name": "node-1",      "healthy": true    },    "spec": {      "vcpus": 2,      "memoryMiB": 2048,      "diskGiB": 12    },    "sourceSnapshotId": null,    "desired": {      "state": "running",      "generation": 1    },    "observed": {      "state": "running",      "generation": 1,      "observedAt": "2026-11-05T10:15:04.000Z",      "ageSeconds": 2,      "fresh": true,      "error": null    },    "state": "running",    "hibernateAt": "2026-11-05T11:14:58.000Z",    "hibernationRetryAt": null,    "pooled": false,    "expiresAt": null,    "restartRequired": false,    "connectionGeneration": 1,    "privateIp": "10.20.30.17",    "console": {      "ready": true,      "reason": null    },    "ssh": {      "ready": true,      "reason": null    },    "deletion": null,    "createdAt": "2026-11-05T10:14:21.000Z"  }]