API Reference

Beta

Chat

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Create Session

ChatCreateResponse beta().chat().create(ChatCreateParamsparams = ChatCreateParams.none(), RequestOptionsrequestOptions = RequestOptions.none())

POST/api/v1/chat

Create a chat session, optionally bound to indexes (locked after the first message).

ParametersExpand Collapse

ChatCreateParams params

Optional<String> organizationId

Optional<String> projectId

Optional<List<String>> indexIds

Indexes this session will retrieve from. Once set and the first message has been sent, the source set is locked for the session’s lifetime. Leave null to create an unbound session.

ReturnsExpand Collapse

class ChatCreateResponse:

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

Create 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.ChatCreateParams;
import com.llamacloud_prod.api.models.beta.chat.ChatCreateResponse;

public final class Main {
    private Main() {}

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

        ChatCreateResponse chat = client.beta().chat().create();
    }
}

200 example

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

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