Save a named snapshot

Save a named snapshot

Captures the running computer as a named snapshot. Linux saves files and requires the browser closed. Android saves the guest memory, device data, and matching SDK; the guest is held during capture and resumes afterward. requestId is the caller's idempotency key: repeating it reports the same capture (capturing, ready, failed, or unconfirmed while the fleet has not registered it). Requires space write permission.

POST/api/computers/{id}/snapshots
Path parameters
idstringrequired
Body
requestIdstringrequired
namestringrequired

Request

curl
curl -X POST https://trickest.io/api/computers/{id}/snapshots \
  -H "Authorization: Token $TRICKEST_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ }'

Responses

200The capture
idstringrequired
requestIdstringrequired
namestringrequired
stateenumrequired

One of: capturing, ready, failed, unconfirmed

managedbooleanrequired
createdBystringrequired
createdAtstringrequired
expiresAtstringrequired
sizeBytesnumberrequired
versionnumberrequired
400Bad Request – validation error or malformed input
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

401Unauthorized – missing or expired token
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

403Forbidden – insufficient permissions
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

429Too Many Requests – rate limited
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

500Internal Server Error
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.