List Messages

1 import { LettaClient } from "@letta-ai/letta-client"; 2 3 const client = new LettaClient({ token: "YOUR_TOKEN", project: "YOUR_PROJECT" }); 4 await client.agents.messages.list("agent-123e4567-e89b-42d3-8456-426614174000", { 5 before: "before", 6 after: "after", 7 limit: 1, 8 order: "asc", 9 orderBy: "created_at", 10 groupId: "group_id", 11 useAssistantMessage: true, 12 assistantMessageToolName: "assistant_message_tool_name", 13 assistantMessageToolKwarg: "assistant_message_tool_kwarg", 14 includeErr: true 15 });

1 [ 2 { 3 "id": "string", 4 "date": "2024-01-15T09:30:00Z", 5 "name": "string", 6 "message_type": "system_message", 7 "otid": "string", 8 "sender_id": "string", 9 "step_id": "string", 10 "is_err": true, 11 "seq_id": 1, 12 "run_id": "string", 13 "content": "string" 14 } 15 ]

Retrieve message history for an agent.

Authentication

AuthorizationBearer

Header authentication of the form Bearer <token>

Path parameters

agent_idstringRequiredformat: "^agent-[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"=42 characters

The ID of the agent in the format ‘agent-<uuid4>’

Query parameters

beforestring or nullOptional

Message ID cursor for pagination. Returns messages that come before this message ID in the specified sort order

afterstring or nullOptional

Message ID cursor for pagination. Returns messages that come after this message ID in the specified sort order

limitinteger or nullOptionalDefaults to 100

Maximum number of messages to return

orderenumOptionalDefaults to desc

Sort order for messages by creation time. 'asc' for oldest first, 'desc' for newest first

Allowed values:

order_by"created_at"Optional

Field to sort by

group_idstring or nullOptional

Group ID to filter messages by.

use_assistant_messagebooleanOptionalDefaults to true

Whether to use assistant messages

assistant_message_tool_namestringOptionalDefaults to send_message

The name of the designated message tool.

assistant_message_tool_kwargstringOptionalDefaults to message

The name of the message argument.

include_errboolean or nullOptional

Whether to include error messages and error statuses. For debugging purposes only.

Response

Successful Response

SystemMessageobject

UserMessageobject

ReasoningMessageobject

HiddenReasoningMessageobject

ToolCallMessageobject

ToolReturnMessageobject

AssistantMessageobject

ApprovalRequestMessageobject

ApprovalResponseMessageobject

Authentication

Path parameters

Query parameters

Response

Errors