Open the live desktop of a computer
Starts the desktop stream inside the running computer and returns its viewer URL (read-only until the viewer takes control). Never resumes a stopped computer; 409 while it is not running. The URL carries a random token: the stream port is public, the token is the gate. Requires space read permission for a managed observer lease; legacy viewers grant input and require space write permission.
POST
/api/computers/{id}/viewerPath parameters
idstringrequiredRequest
curl
curl -X POST https://trickest.io/api/computers/{id}/viewer \
-H "Authorization: Token $TRICKEST_TOKEN"Responses
200Viewer URL
urlstringrequiredmanagedbooleanexpiresAtintegerconnectionEventsbooleanrequired400Bad Request – validation error or malformed input
codestringrequiredmessagestringrequireddetailsobjectField-level detail when the error is a validation failure.
401Unauthorized – missing or expired token
codestringrequiredmessagestringrequireddetailsobjectField-level detail when the error is a validation failure.
403Forbidden – insufficient permissions
codestringrequiredmessagestringrequireddetailsobjectField-level detail when the error is a validation failure.
429Too Many Requests – rate limited
codestringrequiredmessagestringrequireddetailsobjectField-level detail when the error is a validation failure.
500Internal Server Error
codestringrequiredmessagestringrequireddetailsobjectField-level detail when the error is a validation failure.