Skip to content

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”.
filter SessionListFilter optional Optional structured selection applied inside the bounded index query before paging. Present — including {} — makes a supporting server echo its canonical form as appliedFilter; omitted keeps the previous behavior.
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"
}
}