TRtraversal

Get All Sessions

Changed on

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

Request

  • Base URL
    https://api.traversal.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.traversal.com/sessions
  • Auth
    none declared

Query parameters

trigger_typeTriggerType[] nullable

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>).

pageinteger nullable

Page number for pagination

limitinteger nullable

Number of sessions per page

pinnedboolean

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

querystring nullable

Case-insensitive substring match on session title.

sharedboolean

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

Changes

  • c939e4d80cd7Revision changes
    • info

      added the enum value chat_channel_join_auto_trigger to the property anyOf[subschema #1]/items/ of the query request parameter trigger_type

    • info

      added the enum value chat_dm to the property anyOf[subschema #1]/items/ of the query request parameter trigger_type

    • info

      added the enum value chat_investigate_command to the property anyOf[subschema #1]/items/ of the query request parameter trigger_type

    • info

      added the enum value chat_mention to the property anyOf[subschema #1]/items/ of the query request parameter trigger_type

    • info

      added the enum value chat_message_auto_trigger to the property anyOf[subschema #1]/items/ of the query request parameter trigger_type

  • 3025330cc50dRevision changes
    • info

      added the enum value alert_event_critical_severity_investigate to the property anyOf[subschema #1]/items/ of the query request parameter trigger_type