ReferenceAPI
Create a checkpoint of memory, writable overlay and /data, pausing a running computer.
curl -X POST "https://api.nevia.cloud/v1/computers/01d4cnjk3xg90y576w8y6t4gdwm/checkpoints" \
-H "Authorization: Bearer $TOKEN" \
-H "Idempotency-Key: 8f1c2a7e-3b4d-4c5e-9f0a-1b2c3d4e5f60" \
-H "Content-Type: application/json" \
-d '{
"name": "before-migration"
}'{
"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}$Header Parameters
Idempotency-Key*
string
Retry key. A retry with the same key and body replays the first response
Length
1 <= length <= 255Request Body
application/json
Behavior
A running computer pauses for milliseconds. A sleeping computer stays asleep. The computer is not disturbed otherwise.
Poll the checkpoint.create operation, or the checkpoint, until state is ready or failed.
Response
application/jsonThe checkpoint in creating, when the create is accepted, with a checkpoint.create operation.