Cubicle

List a Box's operations

GET
/v1/boxes/{box}/operations

Returns the Box's 50 most recent operations of every type (exec, snapshot and restore), newest first, as a bare array. There are no filters or pages.

Any active member of the Box's organization may list them, without a grant. An exec's result is null unless the caller requested it.

See Commands and operations.

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

Up to 50 operations, newest first.

application/json
  1. response
[index: integer]?
Example Request
curl -X GET 'https://api.cubicle.sh/v1/boxes/acme%2Fjob-1/operations'
Example Response
[  {    "id": "6c8e0a2c-4e6a-4b8c-9e0a-4c6e8a0c2e5b",    "boxId": "0f6c2a5e-3b1d-4c8e-9a7f-2d4e6b8c1a3f",    "type": "restore",    "state": "done",    "attempt": 1,    "progress": null,    "result": {      "snapshotId": "5a7c9e1b-3d5f-4a6b-8c0d-2e4f6a8b0c3d"    },    "error": null,    "createdAt": "2026-11-05T10:30:00.000Z",    "startedAt": "2026-11-05T10:30:00.300Z",    "completedAt": "2026-11-05T10:30:41.000Z"  },  {    "id": "9d2e4f6a-1b3c-4d5e-8f7a-6b8c0d2e4f1a",    "boxId": "0f6c2a5e-3b1d-4c8e-9a7f-2d4e6b8c1a3f",    "type": "exec",    "state": "done",    "attempt": 1,    "progress": null,    "result": {      "exitCode": 0,      "stdout": "Linux box-job-1 6.12.8 #1 SMP x86_64 GNU/Linux\n",      "stderr": "",      "timedOut": false,      "truncated": false    },    "error": null,    "createdAt": "2026-11-05T10:16:00.000Z",    "startedAt": "2026-11-05T10:16:00.400Z",    "completedAt": "2026-11-05T10:16:00.900Z"  }]