Pistis
API referenceFollowing

Watch the sandbox's screen

GET
/sessions/{id}/screen

multipart/x-mixed-replace; boundary=pistis-frame, for as long as you read it. Each part is a picture (image/jpeg, with X-Screen-Width and X-Screen-Height when known), sent only when the screen changed, or application/json {"none": "<why>"} while there is no picture (no browser open yet, the agent isn't using the sandbox). The sandbox makes pictures only while someone watches; a slow reader gets the newest picture, never a backlog. Nothing is recorded. Whoever may read the session may watch it.

Authorization

bearer
headerAuthorizationBearer <token>

An API token

Path Parameters

id*string

A session id

Response Body

multipart/x-mixed-replace: JPEG pictures and JSON notes

response?stringmultipart/x-mixed-replace
Example Request
curl -X GET 'http://127.0.0.1:7777/sessions/ses_6c1f2a0b9d3e4f5a6b7c/screen'
Example Response
"string"