sessions_list
- Category: sessions
- Access: read
- Audience: ordinary (an ordinary user normally calls this directly)
Purpose
Recent sessions, optional project.
Arguments
Optional: limit, project.
-
limit. Note: Max rows (1-100, default 100). -
project. Note: Project filter; empty lists visible scope.
Result
JSON object with sessions array and count.
Boundaries
Project-scoped reads; foreign projects read empty. Caller-owned rows only where applicable.
Lifecycle / side effects
Read-only; no rows written.
Errors
Bad types are rejected (strict validator). Failures move nothing (atomic).
Example
{
"project": "x"
}
Result shape:
{
"count": 0,
"sessions": []
}