API Reference

Beta

Chat

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Get Full Session

ChatRetrieveResponse beta().chat().retrieve(ChatRetrieveParamsparams = ChatRetrieveParams.none(), RequestOptionsrequestOptions = RequestOptions.none())

GET/api/v1/chat/{session_id}

Retrieve a full session by ID, including its event history.

ParametersExpand Collapse

ChatRetrieveParams params

Optional<String> sessionId

Optional<String> organizationId

Optional<String> projectId

ReturnsExpand Collapse

class ChatRetrieveResponse:

Full chat session including its complete event history.

List<Event> events

Ordered list of events that make up the conversation history.

One of the following:

class ThinkingDelta:

String content

Optional<Type> type

class TextDelta:

String content

Optional<Type> type

class Thinking:

String content

Optional<Type> type

class Text:

String content

Optional<Type> type

class ToolCall:

Arguments arguments

String callId

String name

Optional<Type> type

class ToolResult:

String callId

String name

JsonValue result

Optional<ImageAttachment> imageAttachment

Coordinates for lazily resolving a page screenshot presigned URL.

String attachmentName

String sourceId

Optional<Type> type

class Stop:

Optional<String> error

boolean isError

Usage usage

Optional<Double> durationMs

Optional<Long> totalInputTokens

Optional<Long> totalOutputTokens

Optional<Long> turns

Optional<Type> type

class UserInput:

String content

Optional<Type> type

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

Get Full Session

Java

HTTP

TypeScript

Python

Java

Go

CLI Tool

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.ChatRetrieveParams;
import com.llamacloud_prod.api.models.beta.chat.ChatRetrieveResponse;

public final class Main {
    private Main() {}

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

        ChatRetrieveResponse chat = client.beta().chat().retrieve("session_id");
    }
}

200 example

{
  "events": [
    {
      "content": "content",
      "type": "thinking_delta"
    }
  ],
  "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
  }
}

Returns Examples

200 example

{
  "events": [
    {
      "content": "content",
      "type": "thinking_delta"
    }
  ],
  "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
  }
}