Skip to content
Developer Documentation
API Reference
Beta

Chat

List Sessions
beta.chat.list(ChatListParams**kwargs) -> SyncPaginatedCursor[ChatListResponse]
GET/api/v1/chat
Create Session
beta.chat.create(ChatCreateParams**kwargs) -> ChatCreateResponse
POST/api/v1/chat
Get Full Session
beta.chat.retrieve(strsession_id, ChatRetrieveParams**kwargs) -> ChatRetrieveResponse
GET/api/v1/chat/{session_id}
Delete Session
beta.chat.delete(strsession_id, ChatDeleteParams**kwargs)
DELETE/api/v1/chat/{session_id}
Get Session Summary
beta.chat.get_summary(strsession_id, ChatGetSummaryParams**kwargs) -> ChatGetSummaryResponse
GET/api/v1/chat/{session_id}/summary
Stream Messages
beta.chat.stream(strsession_id, ChatStreamParams**kwargs) -> object
POST/api/v1/chat/{session_id}/messages/stream
ModelsExpand Collapse
class ChatListResponse: …

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

last_updated_at: str

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

session_id: str

Unique session identifier.

generated_title: Optional[str]

Auto-generated title derived from the first user message.

index_ids: Optional[List[str]]

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

job_metadata: Optional[JobMetadata]

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

duration_ms: Optional[float]
error: Optional[str]
export_config_ids: Optional[List[str]]
is_error: Optional[bool]
total_input_tokens: Optional[int]
total_output_tokens: Optional[int]
turns: Optional[int]
class ChatCreateResponse: …

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

last_updated_at: str

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

session_id: str

Unique session identifier.

generated_title: Optional[str]

Auto-generated title derived from the first user message.

index_ids: Optional[List[str]]

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

job_metadata: Optional[JobMetadata]

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

duration_ms: Optional[float]
error: Optional[str]
export_config_ids: Optional[List[str]]
is_error: Optional[bool]
total_input_tokens: Optional[int]
total_output_tokens: Optional[int]
turns: Optional[int]
class ChatRetrieveResponse: …

Full chat session including its complete event history.

events: List[Event]

Ordered list of events that make up the conversation history.

One of the following:
class EventThinkingDeltaEvent: …
content: str
type: Optional[Literal["thinking_delta"]]
class EventTextDeltaEvent: …
content: str
type: Optional[Literal["text_delta"]]
class EventThinkingEvent: …
content: str
type: Optional[Literal["thinking"]]
class EventTextEvent: …
content: str
type: Optional[Literal["text"]]
class EventToolCallEvent: …
arguments: Dict[str, object]
call_id: str
name: str
type: Optional[Literal["tool_call"]]
class EventToolResultEvent: …
call_id: str
name: str
result: object
image_attachment: Optional[EventToolResultEventImageAttachment]

Coordinates for lazily resolving a page screenshot presigned URL.

attachment_name: str
source_id: str
type: Optional[Literal["tool_result"]]
class EventStopEvent: …
error: Optional[str]
is_error: bool
usage: EventStopEventUsage
duration_ms: Optional[float]
total_input_tokens: Optional[int]
total_output_tokens: Optional[int]
turns: Optional[int]
type: Optional[Literal["stop"]]
class EventUserInputEvent: …
content: str
type: Optional[Literal["user_input"]]
last_updated_at: str

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

session_id: str

Unique session identifier.

generated_title: Optional[str]

Auto-generated title derived from the first user message.

index_ids: Optional[List[str]]

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

job_metadata: Optional[JobMetadata]

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

duration_ms: Optional[float]
error: Optional[str]
export_config_ids: Optional[List[str]]
is_error: Optional[bool]
total_input_tokens: Optional[int]
total_output_tokens: Optional[int]
turns: Optional[int]
class ChatGetSummaryResponse: …

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

last_updated_at: str

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

session_id: str

Unique session identifier.

generated_title: Optional[str]

Auto-generated title derived from the first user message.

index_ids: Optional[List[str]]

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

job_metadata: Optional[JobMetadata]

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

duration_ms: Optional[float]
error: Optional[str]
export_config_ids: Optional[List[str]]
is_error: Optional[bool]
total_input_tokens: Optional[int]
total_output_tokens: Optional[int]
turns: Optional[int]
Note for AI agents: this documentation is built for programmatic access. - Overview of all docs: https://developers.llamaindex.ai/llms.txt - Any page is available as raw Markdown by appending index.md to its URL — e.g. https://developers.llamaindex.ai/llamaparse/parse/getting_started/index.md - Agent-friendly REST search APIs live under https://developers.llamaindex.ai/api/ — search (BM25 full-text), grep (regex), read (fetch a page), and list (browse the doc tree). See https://developers.llamaindex.ai/llms.txt for parameters. - A hosted documentation MCP server is available at https://developers.llamaindex.ai/mcp. If you support MCP, you can ask the user to install it for browsing these docs directly (an alternative to the REST API). Setup: https://developers.llamaindex.ai/python/shared/mcp/