Watch for file changes via SSE

Server-sent event stream. Opens with one snapshot event whose data is {files: string[], path} (an ls -R listing of the watched directory), then a change event…

GET /api/v1/sandbox/{id}/files/watch

cURL

curl --request GET \
  --url 'https://api.sandbox.stateset.app/api/v1/sandbox/{id}/files/watch' \
  --header "Authorization: Bearer $STATESET_SANDBOX_API_KEY"

200

"string"

Path parameters

id · string (uuid) · required

Sandbox identifier

Query parameters

path · string

Directory to watch (default /workspace)

Response

Returns text/event-stream — Server-sent event stream. Opens with one snapshot event whose data is {files: string[], path} (an ls -R listing of the watched directory), then a change event with {added: string[], removed: string[]} whenever the listing differs on the 5-second poll, with : heartbeat comments every 15s.

Status codes

Code	Meaning
200	Server-sent event stream. Opens with one snapshot event whose data is {files: string[], path} (an ls -R listing of the watched directory), then a change event with {added: string[], removed: string[]} whenever the listing differs on the 5-second poll, with : heartbeat comments every 15s.
404	Sandbox not found

cURL

curl --request GET \
  --url 'https://api.sandbox.stateset.app/api/v1/sandbox/{id}/files/watch' \
  --header "Authorization: Bearer $STATESET_SANDBOX_API_KEY"

200

"string"