latestOpenAPI 3.1.02026-08-223321,1001.6 MB

2134ebffd1ef

Get All Sessions

Get all sessions for a user, filtered by organization and optional trigger types.

This ensures users can only see sessions within their organization.

Args: authorized_user: Authorized user with roles (for RBAC checks) trigger_type: Optional list of trigger types to filter by ('auto', 'manual', etc.) session_id: Optional list of session IDs to restrict results to. page: Optional page number for pagination (defaults to 1 if limit is provided) limit: Optional number of sessions per page (if not provided, returns all sessions) pinned: If true, restrict results to sessions the requesting user has pinned. query: Optional case-insensitive substring match on session title. shared: If true, restrict results to sessions shared with the requesting user (view access, excluding sessions they own).

Returns: GetAllSessionsResponse with list of sessions and optional pagination metadata

get/sessions

Query parameters

trigger_typeTriggerType[] nullable

Filter by trigger type (e.g. 'auto', 'manual', 'alerts_chat').

Filter by trigger type (e.g. 'auto', 'manual', 'alerts_chat').

session_idstring[] nullable

Filter to only these session IDs. Repeat the param for multiple (e.g. ?session_id=<id1>&session_id=<id2>).

Filter to only these session IDs. Repeat the param for multiple (e.g. ?session_id=<id1>&session_id=<id2>).

pageinteger nullable

Page number for pagination

Page number for pagination

limitinteger nullable

Number of sessions per page

Number of sessions per page

pinnedboolean

If true, return only sessions the requesting user has pinned.

If true, return only sessions the requesting user has pinned.

querystring nullable

Case-insensitive substring match on session title.

Case-insensitive substring match on session title.

sharedboolean

If true, return only sessions shared with the requesting user (view access, excluding sessions they own).

If true, return only sessions shared with the requesting user (view access, excluding sessions they own).

Response

Successful Response

countinteger nullable

Number of sessions in current page

previnteger nullable

Previous page number

nextinteger nullable

Next page number

totalinteger nullable

Total number of matching sessions across all pages