Get Agent In Context Messages

GET

/v1/agents/:agent_id/memory/messages

Retrieve the messages in the context of a specific agent.

agent_idstringRequired

Successful Response

roleenum

Allowed values: assistantusertoolfunctionsystem

The role of the participant.

created_by_idstringOptional

The id of the user that made this object.

last_updated_by_idstringOptional

The id of the user that made this object.

created_atdatetimeOptional

The timestamp when the object was created.

updated_atdatetimeOptional

The timestamp when the object was last updated.

idstringOptionalformat: "^message-[a-fA-F0-9]{8}"

The human-friendly ID of the Message

textstringOptional

The text of the message.

agent_idstringOptional

The unique identifier of the agent.

modelstringOptional

The model used to make the function call.

namestringOptional

The name of the participant.

tool_callslist of objectsOptional

The list of tool calls requested.

tool_call_idstringOptional

The id of the tool call.

1	[
2	{
3	"role": "assistant",
4	"created_by_id": "created_by_id",
5	"last_updated_by_id": "last_updated_by_id",
6	"created_at": "2024-01-15T09:30:00Z",
7	"updated_at": "2024-01-15T09:30:00Z",
8	"id": "message-123e4567-e89b-12d3-a456-426614174000",
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/memory/messages \
2	-H "Authorization: Bearer <token>"