Sign in
v2
chat
chat

List Sessions

List chat sessions for the authenticated user.

Returns a paginated list of chat sessions belonging to the current user, with pinned sessions first and most-recently-updated as the tiebreaker.

Args: user_id: The authenticated user's ID. limit: Maximum number of sessions to return (1-100). offset: Number of sessions to skip for pagination. expert_id: Restrict the listing to sessions scoped to this expert. pinned_first: Whether pinned sessions precede strict recency ordering.

Returns: ListSessionsResponse: List of session summaries and total count.

get/api/chat/sessions

Query parameters

limitinteger
offsetinteger
expert_idstring nullable
pinned_firstboolean

Keep pinned sessions before recent sessions. Set false for strict recency when adopting the latest expert thread.

Keep pinned sessions before recent sessions. Set false for strict recency when adopting the latest expert thread.

Response

Successful Response

totalinteger required

Changes

Changed in 6 of the 92 revisions of this API.36

  • 7164d7f366801See the full diff
    • ○

      added the new optional query request parameter pinned_first

      new-optional-request-parameter

  • 3840642ede612See the full diff
    • ○

      added the new optional query request parameter expert_id

      new-optional-request-parameter

    • ○

      added the optional property sessions/items/expert_id to the response with the 200 status

      response-optional-property-added

  • 6415527178e01See the full diff
    • ○

      added the optional property sessions/items/is_pinned to the response with the 200 status

      response-optional-property-added

  • 4954735722151See the full diff
    • ○

      added the optional property sessions/items/source_platform to the response with the 200 status

      response-optional-property-added

  • 100122be4ee51See the full diff
    • ○

      added the optional property sessions/items/chat_status to the response with the 200 status

      response-optional-property-added

  • 8c84efcb3afb3See the full diff
    • ●

      removed the optional property sessions/items/chat_status from the response with the 200 status

      response-optional-property-removed

    • ●

      removed the optional property sessions/items/is_pinned from the response with the 200 status

      response-optional-property-removed

    • ●

      removed the optional property sessions/items/source_platform from the response with the 200 status

      response-optional-property-removed

    This revision also has 96 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog