List sessions
List agent sessions visible to the caller, filtered by app, surface, archive status, and team.
Restrictions
Usage
- Pagination uses
p/limit(max 100);scopedefaults toall. allreturns your personal sessions plus team sessions you can access; account admins see all team sessions, but not other users’ personal sessions.team_idsnarrows the visible set and never expands access.is_runningreflects the live run-set;has_unreadis computed per calling user; thecurrent_turn_*fields are always zero here — onlysession/getcomputes them while a session is running.suggest_initis an account-wide onboarding flag (true only when the account has zero knowledge packs anywhere) — it doesn’t depend on the list filters.
Authorizations
App key issued from the Flashduty console. Required on every public API call. Keep it secret — it grants the same access as the owning account.
Body
Filters for listing agent sessions. all visibility means the caller's own personal sessions plus accessible team sessions; account admins do not see other users' personal sessions.
Agent app whose sessions to list.
ask-ai, support, support-website, support-flashcat, ai-sre, template-assistant, swe Page number, 1-based.
x >= 1Page size, 1–100.
1 <= x <= 100Sort field.
created_at, updated_at Ascending order when true; applies only when orderby is set.
Include subagent-dispatched sessions in the list.
Filter by session-name keyword.
64Visibility scope: all (own personal + accessible team sessions), personal, or team; default all.
all, personal, team Optional explicit team filter; intersects with scope and never expands access.
Restrict to sessions produced by these surfaces; empty returns every kind.
web, im, api, automation Archive bucket: active (default) returns un-archived, archived returns archived, all returns both.
active, archived, all Response
Success
Standard response envelope used by every Flashduty public API. On success data contains the endpoint-specific payload and error is absent. On failure error is present and data is absent. request_id is always present and is also mirrored in the Flashcat-Request-Id response header.