ReferenceAPI

List workspace checkpoints

List every live checkpoint across a workspace's computers, newest first.

GET https://api.nevia.cloud/v1/checkpoints
curl -X GET "https://api.nevia.cloud/v1/checkpoints?workspace=01d4cnjjq40hnnh0nwmkg35nv2h" \
  -H "Authorization: Bearer $TOKEN"
{
  "checkpoints": [
    {
      "id": "01d4cnjkwhftngfp8vkmp723mhv",
      "workspace": "01d4cnjjq40hnnh0nwmkg35nv2h",
      "source_type": "computer",
      "source": "01d4cnjk3xg90y576w8y6t4gdwm",
      "name": "before-migration",
      "consistency": "crash",
      "state": "ready",
      "generation": 1,
      "image_digest": "string",
      "size_bytes": 5368709120,
      "parent": null,
      "error": null,
      "created_at": "2026-09-10T12:34:56Z",
      "deleted_at": null
    }
  ],
  "next_cursor": "string",
  "has_more": true
}

Authorization

bearerAuth
Authorization Bearer <token>

Send the token in the Authorization: Bearer <token> header. See Authenticate.

In: header

Query Parameters

workspace* string

Workspace id or exact name

limit? integer

Page size

Range 1 <= value <= 100
Default 50
cursor? string

next_cursor from the previous page

source? string

Source computer or database id

Match ^[A-Za-z0-9_-]{1,64}$
source_type? string computer · database

Source type to filter by

state? string creating · ready · failed · deleting · deleted

State to filter by

name? string

Exact name to filter by

created_after? string

Created after this time (exclusive)

Format date-time
created_before? string

Created before this time (exclusive)

Format date-time

Behavior

The list shows checkpoints the caller can see. A source the caller cannot see returns an empty page. Deleting a source deletes its checkpoints, so every listed row belongs to a live source.

Response

application/json

Checkpoints the caller can see, newest first.