Skip to main content
GET
List the shared sessions this home holds

Authorizations

Authorization
string
header
required

Enforced on every transport, with no exempt operation. A person's request — over the default local unix socket exactly as over a TCP listener — must carry a JWT issued by the configured identity provider, which the host verifies itself against that issuer's key set: signature, issuer, expiry, and the person and organisation it names. Requests without a valid one receive 401 NRY-0011. The socket's file permissions are transport and are not an authorisation.

Query Parameters

cursor
string

Opaque pagination cursor from a previous page's nextCursor or prevCursor.

Maximum string length: 1024
limit
integer
default:25

Maximum items per page.

Required range: 1 <= x <= 100

Response

One page of the shares this home holds for this caller.

One page of the shared sessions this home holds for whoever is asking, newest first. THE PAGE CAN BE SHORTER THAN ITS LIMIT. The audience rule is asked once per row and the rows a caller may not read are left out, so a page's length says nothing about whether there is another: a client pages until nextCursor is absent.

items
object[]
required
limit
integer
required

The page size this host applied.

Required range: x >= 1
nextCursor
string

Pass as cursor for the next page. Absent when this home holds nothing older.