Skip to the page

Terminal sessions: the person's own, or every one for owners and admins

GET/v1/organisations/{id}/terminal/sessions

Operation terminal.sessions · since 2026-11-05 · stable

Needs a session withreadscopeAnswers200 OK

{ "sessions": [...] }, newest first.

Opening a terminal is the console's: its ticket is bound to the console's address.

Path parameters

idstring (uuid)required
The organisation id.

Query parameters

statestringoptional
"live" or "all".
limitinteger, 1 to 200optional
Sessions at most (default 50).

Errors

Every error is { "error", "message", "detail"? } (Errors and references). Besides the codes any route can answer.

GET/v1/organisations/{id}/terminal/sessions
curl "https://api.rykloud.com/v1/organisations/$ORG_ID/terminal/sessions" \
  -H "Authorization: Bearer $RYKLOUD_TOKEN"