---
title: "List Sessions"
method: GET
path: "/api/chat/sessions"
tags: ["v2", "chat", "chat"]
---

# List Sessions

`GET /api/chat/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.

## Query parameters

- `limit` integer
- `offset` integer
- `expert_id` string, nullable
- `pinned_first` boolean — Keep pinned sessions before recent sessions. Set false for strict recency when adopting the latest expert thread.

## Response `200`

Successful Response

- ListSessionsResponse — Response model for listing chat sessions.
  - `sessions` SessionSummaryResponse[], required
    - `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
  - `total` integer, required

## Other responses

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

## Changes

- **2026-08-16** `7164d7f36680` — 1 info
  - added the new optional `query` request parameter `pinned_first`
- **2026-07-29** `3840642ede61` — 2 info
  - added the new optional `query` request parameter `expert_id`
  - added the optional property `sessions/items/expert_id` to the response with the `200` status
- **2026-07-01** `6415527178e0` — 1 info
  - added the optional property `sessions/items/is_pinned` to the response with the `200` status
- **2026-05-20** `495473572215` — 1 info
  - added the optional property `sessions/items/source_platform` to the response with the `200` status
- **2026-05-11** `100122be4ee5` — 1 info
  - added the optional property `sessions/items/chat_status` to the response with the `200` status

[Full history](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/changes/api/chat/sessions/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-service-production.skmtc.workers.dev/v1/apis/significant-gravitas/autogpt-agent-server/revisions/5dc375899754/schema)