List live connections
GET
/streams/connections/read Read: looks, changes nothing. Scopes
Everyone watching now: one row per connection with the line, what it watches, the server, the address and where it comes from, newest first. Not paged. Rows of lines the caller may not manage are left out.
Query parameters
scopestringWhose lines: the caller's own (
mine, the default for most), theirs and their resellers' (subtree), or every line (all, for accounts allowed to see them all).One of:
"all""mine""subtree"
Response
200 OK
session_idstringrequiredlinestringrequiredread-onlyline_idstring (uuid)requiredread-onlyownerstringrequiredread-onlyUsername of the account that created the line; empty when none did.
groupsstring[]requiredread-onlyThat account's groups, e.g. Reseller.
stream_namestringrequiredread-onlykindstringrequiredread-onlytitlestringrequiredread-onlyserverstringrequiredread-onlycan be nullThe server the viewer was sent to.
ipstringrequiredread-onlyplayerstringrequiredread-onlycan be nullcountry_codestringrequiredread-onlycan be nullispstringrequiredread-onlycan be nullcitystringrequiredread-onlycan be nulloutputstringrequiredread-onlyrestreamerbooleanrequiredread-onlyrestreamer_reasonsstring[]requiredread-onlydatacenterbooleanrequiredread-onlyvpnbooleanrequiredread-onlytorbooleanrequiredread-onlystarted_atstring (date-time)requiredread-onlylast_heartbeatstring (date-time)requiredread-only
Errors
- 401 No credential, or one that is wrong, expired or revoked.
- 403 The account, or the key's or app's scopes, may not do this.
- 429 Slow down: wait the seconds in the Retry-After header, then try again.