API Reference

Beta

Chat

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

List Sessions

ChatListPageResponse Beta.Chat.List(ChatListParams?parameters, CancellationTokencancellationToken = default)

GET/api/v1/chat

List all chat sessions for the current project.

ParametersExpand Collapse

ChatListParams parameters

string? organizationID

Long? pageSize

string? pageToken

string? projectID

ReturnsExpand Collapse

class ChatListPageResponse:

Paginated list of chat sessions.

required IReadOnlyList<ChatListResponse> Items

Chat sessions for the current page.

required string LastUpdatedAt

ISO-format timestamp showing when the session was last updated.

required string SessionID

Unique session identifier.

string? GeneratedTitle

Auto-generated title derived from the first user message.

IReadOnlyList<string>? IndexIds

Indexes this session is bound to. Null on unbound sessions.

JobMetadata? JobMetadata

Token usage and status from the most recent run. Null if the session has not been run yet.

Double DurationMs

string? Error

IReadOnlyList<string>? ExportConfigIds

Boolean IsError

Long? TotalInputTokens

Long? TotalOutputTokens

Long Turns

string? NextPageToken

Opaque token to retrieve the next page. Omitted when there are no further pages.

List Sessions

C#

HTTP

TypeScript

Python

Go

Java

C#

CLI Tool

ChatListParams parameters = new();

var page = await client.Beta.Chat.List(parameters);
await foreach (var item in page.Paginate())
{
    Console.WriteLine(item);
}

200 example

{
  "items": [
    {
      "last_updated_at": "2026-04-22T12:34:41.342245",
      "session_id": "ses-abc123",
      "generated_title": "What were the main findings in Q3?...",
      "index_ids": [
        "idx-abc123",
        "idx-def456"
      ],
      "job_metadata": {
        "duration_ms": 0,
        "error": "error",
        "export_config_ids": [
          "string"
        ],
        "is_error": true,
        "total_input_tokens": 0,
        "total_output_tokens": 0,
        "turns": 0
      }
    }
  ],
  "next_page_token": "next_page_token"
}

Returns Examples

200 example

{
  "items": [
    {
      "last_updated_at": "2026-04-22T12:34:41.342245",
      "session_id": "ses-abc123",
      "generated_title": "What were the main findings in Q3?...",
      "index_ids": [
        "idx-abc123",
        "idx-def456"
      ],
      "job_metadata": {
        "duration_ms": 0,
        "error": "error",
        "export_config_ids": [
          "string"
        ],
        "is_error": true,
        "total_input_tokens": 0,
        "total_output_tokens": 0,
        "turns": 0
      }
    }
  ],
  "next_page_token": "next_page_token"
}