Create, attach, detach, select or associate a conversation computer

Create, attach, detach, select or associate a conversation computer

Create an independent computer identity with a caller-provided retry UUID, or select a target/home with the last observed revision. Detach removes an unselected, unassociated catalog computer from this conversation without deleting the computer. Association requires workflow read access, preserves physical identity and does not change the editor. Selection never stops existing work. Allocation remains lazy and subject to the existing account limits.

POST/api/agent/sessions/{sessionId}/sandboxes
Path parameters
sessionIdnumberrequired

Path parameter: sessionId

Body

Request

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

Responses

200Updated computer inventory and selection
homeIdstringrequired
selectedIdstringrequired
revisionintegerrequired
targetsobject[]required

idstringrequired
namestringrequired
workflowIdstringrequired
keyobjectrequired

workflowIdstring
agentSessionIdstringrequired
androidReservedboolean
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.