List Sessions

client.Beta.Chat.List(ctx, query) (*PaginatedCursor[BetaChatListResponse], error)

GET/api/v1/chat

List all chat sessions for the current project.

ParametersExpand Collapse

query BetaChatListParams

OrganizationID param.Field[string]optional

PageSize param.Field[int64]optional

PageToken param.Field[string]optional

ProjectID param.Field[string]optional

ReturnsExpand Collapse

type BetaChatListResponse struct{…}

Summary of a chat session, including its title and last run metadata.

LastUpdatedAt string

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

SessionID string

Unique session identifier.

GeneratedTitle stringoptional

Auto-generated title derived from the first user message.

IndexIDs []stringoptional

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

JobMetadata BetaChatListResponseJobMetadataoptional

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

DurationMs float64optional

Error stringoptional

ExportConfigIDs []stringoptional

IsError booloptional

TotalInputTokens int64optional

TotalOutputTokens int64optional

Turns int64optional

List Sessions

package main

import (
  "context"
  "fmt"

  "github.com/stainless-sdks/llamacloud-prod-go"
  "github.com/stainless-sdks/llamacloud-prod-go/option"
)

func main() {
  client := llamacloudprod.NewClient(
    option.WithAPIKey("My API Key"),
  )
  page, err := client.Beta.Chat.List(context.TODO(), llamacloudprod.BetaChatListParams{

  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", page)
}

{
  "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

{
  "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"
}