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

List Conversations

conversations.list(ConversationListParams**kwargs) -> ConversationListResponse
get/v1/conversations/

List all conversations for an agent.

ParametersExpand Collapse
agent_id: str

The agent ID to list conversations for

after: Optional[str]

Cursor for pagination (conversation ID)

limit: Optional[int]

Maximum number of conversations to return

ReturnsExpand Collapse
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
List Conversations
import os
from letta_client import Letta

client = Letta(
    api_key=os.environ.get("LETTA_API_KEY"),  # This is the default and can be omitted
)
conversations = client.conversations.list(
    agent_id="agent_id",
)
print(conversations)
[
  {
    "id": "id",
    "agent_id": "agent_id",
    "created_at": "2019-12-27T18:11:19.117Z",
    "created_by_id": "created_by_id",
    "in_context_message_ids": [
      "string"
    ],
    "last_updated_by_id": "last_updated_by_id",
    "summary": "summary",
    "updated_at": "2019-12-27T18:11:19.117Z"
  }
]
Returns Examples
[
  {
    "id": "id",
    "agent_id": "agent_id",
    "created_at": "2019-12-27T18:11:19.117Z",
    "created_by_id": "created_by_id",
    "in_context_message_ids": [
      "string"
    ],
    "last_updated_by_id": "last_updated_by_id",
    "summary": "summary",
    "updated_at": "2019-12-27T18:11:19.117Z"
  }
]