Restore a snapshot into the same computer

Boots the computer from the snapshot, replacing its current files. A running computer is refused with 409 unless the body is { "stopFirst": true }, which stops it first (refused while an agent goal works on it). 409 while the snapshot is still being saved. Requires space write permission.

POST/api/computers/{id}/snapshots/{snapshotId}/restore

Path parameters

idstringrequired

snapshotIdstringrequired

Request

curl

curl -X POST https://trickest.io/api/computers/{id}/snapshots/{snapshotId}/restore \
  -H "Authorization: Token $TRICKEST_TOKEN"

Responses

200The computer after the restore, with any fleet warning

computerobjectrequired

kindenumrequired

One of: linux, android

idstringrequired

spaceIdstringrequired

namestringrequired

stateenumrequired

One of: creating, active, deleting, unconfirmed, deleted

statusenumrequired

One of: pending, running, stopping, stopped, snapshotting, failed, aborted, unavailable

createdBystringrequired

createdAtstringrequired

updatedAtstringrequired

deletedAtstringrequired

nativeobjectrequired

idstringrequired

runtimestring

vcpusnumber

memorynumber

portsnumber[]

timeoutnumber

permissionsobject

writebooleanrequired

sourceobjectrequired

computerIdstringrequired

snapshotIdstringrequired

activityobjectrequired

stateenumrequired

One of: working, idle

lastStateenumrequired

One of: running, completed, failed, unconfirmed

sourceenumrequired

One of: agent, workflow, user

operationenumrequired

One of: command, start, stop, restore, capture, create

sessionIdstringrequired

runIdstringrequired

workflowIdstringrequired

toolNamestringrequired

observedAtstringrequired

goalobjectrequired

warningstringrequired

400Bad Request – validation error or malformed input

codestringrequired

messagestringrequired

detailsobject