List Messages For Group

Retrieve message history for an agent.

group_idstringRequired

AuthorizationstringRequired

Header authentication of the form Bearer <token>

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 10

Maximum number of messages to retrieve

orderenumOptionalDefaults to desc

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

Allowed values:

order_by"created_at"OptionalDefaults to created_at

Field to sort 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.

Successful Response

SystemMessageobject

UserMessageobject

ReasoningMessageobject

HiddenReasoningMessageobject

ToolCallMessageobject

ToolReturnMessageobject

AssistantMessageobject

ApprovalRequestMessageobject

ApprovalResponseMessageobject

1	from letta_client import Letta
2
3	client = Letta(
4	project="YOUR_PROJECT",
5	token="YOUR_TOKEN",
6	)
7	client.groups.messages.list(
8	group_id="group_id",
9	)