List Agents — Letta

List all agents associated with a given user. This endpoint retrieves a list of all agents and their configurations associated with the specified user ID.

Query parameters

namestringOptional

Name of the agent

tagsstringOptional

List of tags to filter agents by

match_all_tagsbooleanOptionalDefaults to false

If True, only returns agents that match ALL given tags. Otherwise, return agents that have ANY of the passed in tags.

beforestringOptional

Cursor for pagination

afterstringOptional

Cursor for pagination

limitintegerOptional

Limit for pagination

query_textstringOptional

Search agents by name

project_idstringOptional

Search agents by project id

template_idstringOptional

Search agents by template id

base_template_idstringOptional

Search agents by base template id

identifier_keysstringOptional

Search agents by identifier keys

Response

Successful Response

list of objects or null

Errors

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

1 [ 2 { 3 "id": "id", 4 "name": "name", 5 "system": "system", 6 "agent_type": "memgpt_agent", 7 "llm_config": { 8 "model": "model", 9 "model_endpoint_type": "openai", 10 "context_window": 1, 11 "model_endpoint": "model_endpoint", 12 "model_wrapper": "model_wrapper", 13 "put_inner_thoughts_in_kwargs": true, 14 "handle": "handle", 15 "temperature": 1.1, 16 "max_tokens": 1 17 }, 18 "embedding_config": { 19 "embedding_endpoint_type": "openai", 20 "embedding_model": "embedding_model", 21 "embedding_dim": 1, 22 "embedding_endpoint": "embedding_endpoint", 23 "embedding_chunk_size": 1, 24 "handle": "handle", 25 "azure_endpoint": "azure_endpoint", 26 "azure_version": "azure_version", 27 "azure_deployment": "azure_deployment" 28 }, 29 "memory": { 30 "blocks": [ 31 { 32 "value": "value", 33 "id": "block-123e4567-e89b-12d3-a456-426614174000" 34 } 35 ], 36 "prompt_template": "prompt_template" 37 }, 38 "tools": [ 39 { 40 "id": "tool-123e4567-e89b-12d3-a456-426614174000" 41 } 42 ], 43 "sources": [ 44 { 45 "name": "name", 46 "embedding_config": { 47 "embedding_endpoint_type": "openai", 48 "embedding_model": "embedding_model", 49 "embedding_dim": 1 50 }, 51 "id": "source-123e4567-e89b-12d3-a456-426614174000" 52 } 53 ], 54 "tags": [ 55 "tags" 56 ], 57 "created_by_id": "created_by_id", 58 "last_updated_by_id": "last_updated_by_id", 59 "created_at": "2024-01-15T09:30:00Z", 60 "updated_at": "2024-01-15T09:30:00Z", 61 "tool_rules": [ 62 { 63 "tool_name": "tool_name", 64 "type": "conditional", 65 "child_output_mapping": { 66 "key": "value" 67 } 68 } 69 ], 70 "message_ids": [ 71 "message_ids" 72 ], 73 "description": "description", 74 "metadata": { 75 "key": "value" 76 }, 77 "tool_exec_environment_variables": [ 78 { 79 "key": "key", 80 "value": "value", 81 "agent_id": "agent_id", 82 "id": "agent-env-123e4567-e89b-12d3-a456-426614174000" 83 } 84 ], 85 "project_id": "project_id", 86 "template_id": "template_id", 87 "base_template_id": "base_template_id", 88 "identity_ids": [ 89 "identity_ids" 90 ], 91 "message_buffer_autoclear": true 92 } 93 ]

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

1	[
2	{
3	"id": "id",
4	"name": "name",
5	"system": "system",
6	"agent_type": "memgpt_agent",
7	"llm_config": {
8	"model": "model",
9	"model_endpoint_type": "openai",
10	"context_window": 1,
11	"model_endpoint": "model_endpoint",
12	"model_wrapper": "model_wrapper",
13	"put_inner_thoughts_in_kwargs": true,
14	"handle": "handle",
15	"temperature": 1.1,
16	"max_tokens": 1
17	},
18	"embedding_config": {
19	"embedding_endpoint_type": "openai",
20	"embedding_model": "embedding_model",
21	"embedding_dim": 1,
22	"embedding_endpoint": "embedding_endpoint",
23	"embedding_chunk_size": 1,
24	"handle": "handle",
25	"azure_endpoint": "azure_endpoint",
26	"azure_version": "azure_version",
27	"azure_deployment": "azure_deployment"
28	},
29	"memory": {
30	"blocks": [
31	{
32	"value": "value",
33	"id": "block-123e4567-e89b-12d3-a456-426614174000"
34	}
35	],
36	"prompt_template": "prompt_template"
37	},
38	"tools": [
39	{
40	"id": "tool-123e4567-e89b-12d3-a456-426614174000"
41	}
42	],
43	"sources": [
44	{
45	"name": "name",
46	"embedding_config": {
47	"embedding_endpoint_type": "openai",
48	"embedding_model": "embedding_model",
49	"embedding_dim": 1
50	},
51	"id": "source-123e4567-e89b-12d3-a456-426614174000"
52	}
53	],
54	"tags": [
55	"tags"
56	],
57	"created_by_id": "created_by_id",
58	"last_updated_by_id": "last_updated_by_id",
59	"created_at": "2024-01-15T09:30:00Z",
60	"updated_at": "2024-01-15T09:30:00Z",
61	"tool_rules": [
62	{
63	"tool_name": "tool_name",
64	"type": "conditional",
65	"child_output_mapping": {
66	"key": "value"
67	}
68	}
69	],
70	"message_ids": [
71	"message_ids"
72	],
73	"description": "description",
74	"metadata": {
75	"key": "value"
76	},
77	"tool_exec_environment_variables": [
78	{
79	"key": "key",
80	"value": "value",
81	"agent_id": "agent_id",
82	"id": "agent-env-123e4567-e89b-12d3-a456-426614174000"
83	}
84	],
85	"project_id": "project_id",
86	"template_id": "template_id",
87	"base_template_id": "base_template_id",
88	"identity_ids": [
89	"identity_ids"
90	],
91	"message_buffer_autoclear": true
92	}
93	]