ReferenceAPI

Delete a checkpoint

Delete a checkpoint of the computer, with completion tracked by an operation.

DELETE https://api.nevia.cloud/v1/computers/{cmp}/checkpoints/{chk}
curl -X DELETE "https://api.nevia.cloud/v1/computers/01d4cnjk3xg90y576w8y6t4gdwm/checkpoints/01d4cnjkwhftngfp8vkmp723mhv" \
  -H "Authorization: Bearer $TOKEN"
{
  "checkpoint": {
    "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
  },
  "operations": [
    "01d4cnjm89yk0r3xtv80dy0x7by"
  ]
}

Authorization

bearerAuth
Authorization Bearer <token>

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

In: header

Path Parameters

cmp* string

Computer id: 27 lowercase letters and digits.

Match ^[A-Za-z0-9_-]{1,64}$
chk* string

Checkpoint id: 27 lowercase letters and digits.

Match ^[A-Za-z0-9_-]{1,64}$

Header Parameters

Idempotency-Key? string

Optional retry key, kept 24 hours

Length 1 <= length <= 255

Response

application/json

Deletion started. The checkpoint is deleting. Poll the checkpoint.delete operation until it finishes.