List Conversations

get/v1/conversations/

List all conversations for an agent.

Query ParametersExpand Collapse

agent_id: string

The agent ID to list conversations for

after: optional string

Cursor for pagination (conversation ID)

limit: optional number

Maximum number of conversations to return

ReturnsExpand Collapse

id: string

The unique identifier of the conversation.

agent_id: string

The ID of the agent this conversation belongs to.

created_at: optional string

The timestamp when the object was created.

formatdate-time

created_by_id: optional string

The id of the user that made this object.

in_context_message_ids: optional array of string

The IDs of in-context messages for the conversation.

last_updated_by_id: optional string

The id of the user that made this object.

summary: optional string

A summary of the conversation.

updated_at: optional string

The timestamp when the object was last updated.

formatdate-time

List Conversations

curl https://api.letta.com/v1/conversations/ \
    -H "Authorization: Bearer $LETTA_API_KEY"

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