Request or return human control of a Computer Use node

Read the current control state, request or renew a viewer lease, or resume a Computer Use node. Supply the run ID, subjob ID, a viewer UUID in viewId, and one of status, request, renew, or resume. The caller must have access to the run and its computer. Browser Use nodes do not support takeover through this endpoint. Unsupported takeover, unavailable control, or control held by another viewer returns 409.

POST/api/runs/{id}/subjobs/{subjobId}/computer-control

Path parameters

idstringrequired

subjobIdstringrequired

Body

actionenumrequired

One of: status, request, renew, resume

viewIdstringrequired

Request

curl

curl -X POST https://trickest.io/api/runs/{id}/subjobs/{subjobId}/computer-control \
  -H "Authorization: Token $TRICKEST_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ }'

Responses

200Confirmed runner control state

modeenumrequired

One of: running, pausing, paused, expired, finished

ownedbooleanrequired

leaseUntilnumberrequired

assistedbooleanrequired

busybooleanrequired

400Bad Request – validation error or malformed input

codestringrequired

messagestringrequired

detailsobject