Get Agent Context Window — Letta

Retrieve the context window of a specific agent.

Path parameters

agent_idstringRequired

Response

Successful Response

context_window_size_maxinteger

The maximum amount of tokens the context window can hold.

context_window_size_currentinteger

The current number of tokens in the context window.

num_messagesinteger

The number of messages in the context window.

num_archival_memoryinteger

The number of messages in the archival memory.

num_recall_memoryinteger

The number of messages in the recall memory.

num_tokens_external_memory_summaryinteger

The number of tokens in the external memory summary (archival + recall metadata).

num_tokens_systeminteger

The number of tokens in the system prompt.

system_promptstring

The content of the system prompt.

num_tokens_core_memoryinteger

The number of tokens in the core memory.

core_memorystring

The content of the core memory.

num_tokens_summary_memoryinteger

The number of tokens in the summary memory.

num_tokens_functions_definitionsinteger

The number of tokens in the functions definitions.

num_tokens_messagesinteger

The number of tokens in the messages list.

messageslist of objects

The messages in the context window.

summary_memorystringOptional

The content of the summary memory.

functions_definitionslist of objectsOptional

The content of the functions definitions.

Errors

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

1 { 2 "context_window_size_max": 1, 3 "context_window_size_current": 1, 4 "num_messages": 1, 5 "num_archival_memory": 1, 6 "num_recall_memory": 1, 7 "num_tokens_external_memory_summary": 1, 8 "num_tokens_system": 1, 9 "system_prompt": "system_prompt", 10 "num_tokens_core_memory": 1, 11 "core_memory": "core_memory", 12 "num_tokens_summary_memory": 1, 13 "num_tokens_functions_definitions": 1, 14 "num_tokens_messages": 1, 15 "messages": [ 16 { 17 "role": "assistant", 18 "created_by_id": "created_by_id", 19 "last_updated_by_id": "last_updated_by_id", 20 "created_at": "2024-01-15T09:30:00Z", 21 "updated_at": "2024-01-15T09:30:00Z", 22 "id": "message-123e4567-e89b-12d3-a456-426614174000", 23 "text": "text", 24 "organization_id": "organization_id", 25 "agent_id": "agent_id", 26 "model": "model", 27 "name": "name", 28 "tool_calls": [ 29 { 30 "id": "id", 31 "function": { 32 "name": "name", 33 "arguments": "arguments" 34 } 35 } 36 ], 37 "tool_call_id": "tool_call_id" 38 } 39 ], 40 "summary_memory": "summary_memory", 41 "functions_definitions": [ 42 { 43 "function": { 44 "name": "name" 45 }, 46 "type": "function" 47 } 48 ] 49 }

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

1	{
2	"context_window_size_max": 1,
3	"context_window_size_current": 1,
4	"num_messages": 1,
5	"num_archival_memory": 1,
6	"num_recall_memory": 1,
7	"num_tokens_external_memory_summary": 1,
8	"num_tokens_system": 1,
9	"system_prompt": "system_prompt",
10	"num_tokens_core_memory": 1,
11	"core_memory": "core_memory",
12	"num_tokens_summary_memory": 1,
13	"num_tokens_functions_definitions": 1,
14	"num_tokens_messages": 1,
15	"messages": [
16	{
17	"role": "assistant",
18	"created_by_id": "created_by_id",
19	"last_updated_by_id": "last_updated_by_id",
20	"created_at": "2024-01-15T09:30:00Z",
21	"updated_at": "2024-01-15T09:30:00Z",
22	"id": "message-123e4567-e89b-12d3-a456-426614174000",
23	"text": "text",
24	"organization_id": "organization_id",
25	"agent_id": "agent_id",
26	"model": "model",
27	"name": "name",
28	"tool_calls": [
29	{
30	"id": "id",
31	"function": {
32	"name": "name",
33	"arguments": "arguments"
34	}
35	}
36	],
37	"tool_call_id": "tool_call_id"
38	}
39	],
40	"summary_memory": "summary_memory",
41	"functions_definitions": [
42	{
43	"function": {
44	"name": "name"
45	},
46	"type": "function"
47	}
48	]
49	}