Cubicle

List a Box's snapshots

GET
/v1/boxes/{box}/snapshots

Returns every snapshot of the Box, newest first, as a bare array: pending, complete and failed ones. Any active member of the Box's organization may list them, without a grant.

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

box*string

The Box's ID, ORG/NAME with the slash encoded as %2F, or a bare NAME, which ?org= narrows. See Box references.

Query Parameters

org?string

The organization's ID or name, to narrow a bare NAME in {box}. Ignored for an ID or ORG/NAME.

Response Body

The Box's snapshots, newest first.

application/json
  1. response
[index: integer]?
Example Request
curl -X GET 'https://api.cubicle.sh/v1/boxes/acme%2Fjob-1/snapshots'
Example Response
[  {    "id": "5a7c9e1b-3d5f-4a6b-8c0d-2e4f6a8b0c3d",    "name": "before-upgrade",    "status": "complete",    "operationId": "3e5a7c9e-1b3d-4f5a-8c7e-9b1d3f5a7c2e",    "createdAt": "2026-11-05T10:20:00.000Z",    "completedAt": "2026-11-05T10:21:12.000Z"  }]