SIsignificant-gravitas
v2
chat
chat

List Sessions

Changed on

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

Request

  • The document declares no server URL.
  • Auth
    HTTP bearer

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.

Response

Successful Response

totalinteger required

Changes

  • 7164d7f36680Revision changes
    • info

      added the new optional query request parameter pinned_first

  • 3840642ede61Revision changes
    • info

      added the new optional query request parameter expert_id

    • info

      added the optional property // to the response with the status