Create a computer

Create a computer

Creates a persistent computer in a space. kind defaults to linux; android uses the Android fleet and starts its guest on the same canonical computer (license acceptance may be required in Mobile). Android requires the Android feature. Copies preserve their source device type; Android snapshots resume their verified live checkpoint on compatible runtimes. requestId is the caller's idempotency key: repeating a request returns the same computer, including after a lost response. With source, the computer is a copy booted from that snapshot of a computer the caller can read; source.stopSource stops that computer first (its saved login runs on one computer at a time) and needs write access to it. Requires space write permission, Enterprise and available spend.

POST/api/computers
Body
kindobject
requestIdstringrequired
spaceIdstringrequired
namestringrequired
sourceobject

computerIdstringrequired
snapshotIdstringrequired
stopSourceboolean

Request

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

Responses

201The computer
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
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.