---
title: "List Session Groups"
method: GET
path: "/api/chat/session-groups"
tags: ["v2", "chat"]
---

# List Session Groups

`GET /api/chat/session-groups`

## Request

- The document declares no server URL.
- Auth: HTTP bearer

List the user's chats grouped by expert, for the sidebar.

Every group, Otto's own (``expert_id`` null) included, carries its real
chat count and at least its ``min_per_group`` newest chats; the newest of
the rest fill the list up to ``limit``, so the groups in use show more.
The most recently active group comes first. Page further into a group
with ``GET /sessions`` and ``expert_id``, or ``autopilot_only`` for
Otto's.

## Query parameters

- `min_per_group` integer: The newest chats every group lists, however old.
- `limit` integer: Chats to list in all: the newest beyond each group's minimum fill up to this. The minimums alone can pass it.
- `pinned_separately` boolean: Return pinned chats in `pinned` and leave them out of the groups and their totals.

## Response `200`

Successful Response

- ListSessionGroupsResponse: The sidebar's chats, grouped by expert, most recently active first.
  - `groups` SessionGroupResponse[], required
    - `expert_id` string, nullable
    - `total` integer, required: Every chat in the group, not just those listed.
    - `sessions` SessionSummaryResponse[], required: The group's newest chats, newest first.
      - `id` string, required
      - `created_at` string, required
      - `updated_at` string, required
      - `title` string, nullable
      - `chat_status` string
      - `is_processing` boolean, required
      - `source_platform` string, nullable
      - `is_pinned` boolean
      - `expert_id` string, nullable
  - `pinned` SessionSummaryResponse[]: Pinned chats, newest first, when asked for separately.
    - `id` string, required
    - `created_at` string, required
    - `updated_at` string, required
    - `title` string, nullable
    - `chat_status` string
    - `is_processing` boolean, required
    - `source_platform` string, nullable
    - `is_pinned` boolean
    - `expert_id` string, nullable

## Other responses

- `401`: Authentication required
- `422`: Validation Error

## Changes

- **2026-11-13** `715df0bfe7c0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/changes/api/chat/session-groups/get.md)

---

[API](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server.md) - [All operations](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/llms.txt) - [OpenAPI document](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/revisions/8dcbed0f0ce8?raw)
