Create a reusable snapshot
import requests
url = "https://api.13-215-85-171.sslip.io/v1/machines/{id}/snapshots"
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>"
}
response = requests.post(url, headers=headers)
print(response.text)curl --request POST \
--url https://api.13-215-85-171.sslip.io/v1/machines/{id}/snapshots \
--header 'Authorization: Bearer <token>' \
--header 'Idempotency-Key: <idempotency-key>'{
"id": "<string>",
"machine_id": "<string>",
"size_bytes": 123,
"created_at": "2023-11-07T05:31:56Z",
"metadata": {}
}
Machines
Create a reusable snapshot
Briefly pauses the running source machine, captures VM memory and
mutable rootfs state into a durable reusable snapshot artifact, then
resumes the source machine. The returned snapshot can be passed to
POST /v1/machines as snapshot_id multiple times; each create starts
an independent fresh machine and leaves the snapshot reusable.
POST
/
v1
/
machines
/
{id}
/
snapshots
Create a reusable snapshot
import requests
url = "https://api.13-215-85-171.sslip.io/v1/machines/{id}/snapshots"
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>"
}
response = requests.post(url, headers=headers)
print(response.text)curl --request POST \
--url https://api.13-215-85-171.sslip.io/v1/machines/{id}/snapshots \
--header 'Authorization: Bearer <token>' \
--header 'Idempotency-Key: <idempotency-key>'{
"id": "<string>",
"machine_id": "<string>",
"size_bytes": 123,
"created_at": "2023-11-07T05:31:56Z",
"metadata": {}
}
Authorizations
API key passed as Bearer token
Headers
Reuse the same key to safely retry the same create, reusable snapshot create, fork, upload create/complete, or agent deployment create operation without duplicating work.
Path Parameters
Machine ID (e.g. mch_a1b2c3d4)