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

Conversations

Create Conversation
conversations.create(ConversationCreateParams**kwargs) -> Conversation
post/v1/conversations/
List Conversations
conversations.list(ConversationListParams**kwargs) -> ConversationListResponse
get/v1/conversations/
Retrieve Conversation
conversations.retrieve(strconversation_id) -> Conversation
get/v1/conversations/{conversation_id}
ModelsExpand Collapse
class Conversation: …

Represents a conversation on an agent for concurrent messaging.

id: str

The unique identifier of the conversation.

agent_id: str

The ID of the agent this conversation belongs to.

created_at: Optional[datetime]

The timestamp when the object was created.

formatdate-time
created_by_id: Optional[str]

The id of the user that made this object.

in_context_message_ids: Optional[List[str]]

The IDs of in-context messages for the conversation.

last_updated_by_id: Optional[str]

The id of the user that made this object.

summary: Optional[str]

A summary of the conversation.

updated_at: Optional[datetime]

The timestamp when the object was last updated.

formatdate-time
class CreateConversation: …

Request model for creating a new conversation.

summary: Optional[str]

A summary of the conversation.

ConversationsMessages

List Conversation Messages
conversations.messages.list(strconversation_id, MessageListParams**kwargs) -> MessageListResponse
get/v1/conversations/{conversation_id}/messages
Send Conversation Message
conversations.messages.create(strconversation_id, MessageCreateParams**kwargs) -> LettaStreamingResponse
post/v1/conversations/{conversation_id}/messages
Retrieve Conversation Stream
conversations.messages.stream(strconversation_id, MessageStreamParams**kwargs) -> object
post/v1/conversations/{conversation_id}/stream