Get Agent Messages

GET

/v1/agents/:agent_id/messages

Retrieve message history for an agent.

agent_idstringRequired

beforestringOptional

Message before which to retrieve the returned messages.

limitintegerOptionalDefaults to 10

Maximum number of messages to retrieve.

msg_objectbooleanOptionalDefaults to false

If true, returns Message objects. If false, return LettaMessage objects.

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 in the designated message tool.

Successful Response

list of objects

1	[
2	{
3	"created_by_id": "created_by_id",
4	"last_updated_by_id": "last_updated_by_id",
5	"created_at": "2024-01-15T09:30:00Z",
6	"updated_at": "2024-01-15T09:30:00Z",
7	"id": "message-123e4567-e89b-12d3-a456-426614174000",
8	"role": "assistant",
9	"text": "text",
10	"agent_id": "agent_id",
11	"model": "model",
12	"name": "name",
13	"tool_calls": [
14	{
15	"id": "id",
16	"function": {
17	"name": "name",
18	"arguments": "arguments"
19	}
20	}
21	],
22	"tool_call_id": "tool_call_id"
23	}
24	]

1	curl https://app.letta.com/v1/agents/agent_id/messages \
2	-H "Authorization: Bearer <token>"