Skip to content
Developer Preview

session/list

Pages through stored sessions under the sessions root for history and picker UIs; read-only, never touches leases.

Type: SessionListParams

session/list params. Read-only; never touches leases.

Field Type Stability Presence Description
cursor string | null optional Opaque page cursor from a prior result. Page cursors are a distinct opaque-string family from view cursors and stream cursors, valid only for re-issuing the same listing. Omitted and explicit null both mean “first page”.
limit integer optional Page size; default 50, max 200 — the cap is published under an owner ruling.
updatedAfter string optional Only sessions with log activity after this RFC3339 instant.
workspaceRoot string optional Only sessions whose metadata workspace root equals this path.
Source

schema/msp/experimental/msp.schema.json#/methods/session~2Flist

{
"description": "Pages through stored sessions under the sessions root for history and picker UIs; read-only, never touches leases.",
"params": {
"$ref": "#/$defs/SessionListParams"
},
"result": {
"$ref": "#/$defs/SessionListResult"
}
}