Skip to content
My Docs My Docs Letta Docs
Sign up
API Reference

Conversations

Create Conversation
client.conversations.create(ConversationCreateParams { agent_id, summary } params, RequestOptionsoptions?): Conversation { id, agent_id, created_at, 5 more }
post/v1/conversations/
List Conversations
client.conversations.list(ConversationListParams { agent_id, after, limit } query, RequestOptionsoptions?): ConversationListResponse { id, agent_id, created_at, 5 more }
get/v1/conversations/
Retrieve Conversation
client.conversations.retrieve(stringconversationID, RequestOptionsoptions?): Conversation { id, agent_id, created_at, 5 more }
get/v1/conversations/{conversation_id}
ModelsExpand Collapse
Conversation { id, agent_id, created_at, 5 more }

Represents a conversation on an agent for concurrent messaging.

id: string

The unique identifier of the conversation.

agent_id: string

The ID of the agent this conversation belongs to.

created_at?: string | null

The timestamp when the object was created.

formatdate-time
created_by_id?: string | null

The id of the user that made this object.

in_context_message_ids?: Array<string>

The IDs of in-context messages for the conversation.

last_updated_by_id?: string | null

The id of the user that made this object.

summary?: string | null

A summary of the conversation.

updated_at?: string | null

The timestamp when the object was last updated.

formatdate-time
CreateConversation { summary }

Request model for creating a new conversation.

summary?: string | null

A summary of the conversation.

ConversationsMessages

List Conversation Messages
client.conversations.messages.list(stringconversationID, MessageListParams { after, before, limit } query?, RequestOptionsoptions?): MessageListResponse { , , , 8 more }
get/v1/conversations/{conversation_id}/messages
Send Conversation Message
client.conversations.messages.create(stringconversationID, MessageCreateParams { assistant_message_tool_kwarg, assistant_message_tool_name, background, 10 more } body, RequestOptionsoptions?): LettaStreamingResponse | Stream<LettaStreamingResponse>
post/v1/conversations/{conversation_id}/messages
Retrieve Conversation Stream
client.conversations.messages.stream(stringconversationID, MessageStreamParams { batch_size, include_pings, poll_interval, starting_after } body?, RequestOptionsoptions?): MessageStreamResponse | Stream<LettaStreamingResponse>
post/v1/conversations/{conversation_id}/stream