List Sessions

ChatListPage beta().chat().list(, )

GET/api/v1/chat

List all chat sessions for the current project.

ParametersExpand Collapse

ChatListParams params

Optional<String> organizationId

Optional<Long> pageSize

Optional<String> pageToken

Optional<String> projectId

ReturnsExpand Collapse

class ChatListResponse:

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

String lastUpdatedAt

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

String sessionId

Unique session identifier.

Optional<String> generatedTitle

Auto-generated title derived from the first user message.

Optional<List<String>> indexIds

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

Optional<JobMetadata> jobMetadata

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

Optional<Double> durationMs

Optional<String> error

Optional<List<String>> exportConfigIds

Optional<Boolean> isError

Optional<Long> totalInputTokens

Optional<Long> totalOutputTokens

Optional<Long> turns

List Sessions

package com.llamacloud_prod.api.example;

import com.llamacloud_prod.api.client.LlamaCloudClient;
import com.llamacloud_prod.api.client.okhttp.LlamaCloudOkHttpClient;
import com.llamacloud_prod.api.models.beta.chat.ChatListPage;
import com.llamacloud_prod.api.models.beta.chat.ChatListParams;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        LlamaCloudClient client = LlamaCloudOkHttpClient.fromEnv();

        ChatListPage page = client.beta().chat().list();
    }
}

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