List Agents | Letta

1 from letta_client import Letta 2 3 client = Letta( 4 token="YOUR_TOKEN", 5 ) 6 client.agents.list()

1 [ 2 { 3 "id": "foo", 4 "name": "foo", 5 "system": "foo", 6 "agent_type": "memgpt_agent", 7 "llm_config": { 8 "model": "foo", 9 "model_endpoint_type": "openai", 10 "context_window": 42, 11 "model_endpoint": "foo", 12 "provider_name": "foo", 13 "provider_category": "base", 14 "model_wrapper": "foo", 15 "put_inner_thoughts_in_kwargs": true, 16 "handle": "foo", 17 "temperature": 0.7, 18 "max_tokens": 42, 19 "enable_reasoner": false, 20 "reasoning_effort": "low", 21 "max_reasoning_tokens": 0 22 }, 23 "embedding_config": { 24 "embedding_endpoint_type": "openai", 25 "embedding_model": "foo", 26 "embedding_dim": 42, 27 "embedding_endpoint": "foo", 28 "embedding_chunk_size": 42, 29 "handle": "foo", 30 "azure_endpoint": "foo", 31 "azure_version": "foo", 32 "azure_deployment": "foo" 33 }, 34 "memory": { 35 "blocks": [ 36 { 37 "value": "foo", 38 "limit": 5000, 39 "name": "foo", 40 "is_template": false, 41 "preserve_on_migration": true, 42 "label": "foo", 43 "read_only": false, 44 "description": "foo", 45 "metadata": {}, 46 "id": "block-123e4567-e89b-12d3-a456-426614174000", 47 "created_by_id": "foo", 48 "last_updated_by_id": "foo" 49 } 50 ], 51 "file_blocks": [ 52 { 53 "value": "foo", 54 "limit": 5000, 55 "name": "foo", 56 "is_template": false, 57 "preserve_on_migration": true, 58 "label": "foo", 59 "read_only": false, 60 "description": "foo", 61 "metadata": {}, 62 "id": "block-123e4567-e89b-12d3-a456-426614174000", 63 "created_by_id": "foo", 64 "last_updated_by_id": "foo" 65 } 66 ], 67 "prompt_template": "{% for block in blocks %}<{{ block.label }}>\n<metadata>read_only=\"{{ block.read_only}}\" chars_current=\"{{ block.value|length }}\" chars_limit=\"{{ block.limit }}\"</metadata><value>{{ block.value }}\n</value></{{ block.label }}>\n{% if not loop.last %}\n{% endif %}{% endfor %}" 68 }, 69 "tools": [ 70 { 71 "id": "tool-123e4567-e89b-12d3-a456-426614174000", 72 "tool_type": "custom", 73 "description": "foo", 74 "source_type": "foo", 75 "name": "foo", 76 "tags": [ 77 "foo" 78 ], 79 "source_code": "foo", 80 "json_schema": {}, 81 "args_json_schema": {}, 82 "return_char_limit": 6000, 83 "pip_requirements": [ 84 { 85 "name": "foo", 86 "version": "foo" 87 } 88 ], 89 "created_by_id": "foo", 90 "last_updated_by_id": "foo", 91 "metadata_": {} 92 } 93 ], 94 "sources": [ 95 { 96 "name": "foo", 97 "embedding_config": { 98 "embedding_endpoint_type": "openai", 99 "embedding_model": "foo", 100 "embedding_dim": 42, 101 "embedding_endpoint": "foo", 102 "embedding_chunk_size": 42, 103 "handle": "foo", 104 "azure_endpoint": "foo", 105 "azure_version": "foo", 106 "azure_deployment": "foo" 107 }, 108 "id": "source-123e4567-e89b-12d3-a456-426614174000", 109 "description": "foo", 110 "instructions": "foo", 111 "metadata": {}, 112 "created_by_id": "foo", 113 "last_updated_by_id": "foo", 114 "created_at": "foo", 115 "updated_at": "foo" 116 } 117 ], 118 "tags": [ 119 "foo" 120 ], 121 "created_by_id": "foo", 122 "last_updated_by_id": "foo", 123 "created_at": "foo", 124 "updated_at": "foo", 125 "tool_rules": [ 126 { 127 "tool_name": "foo", 128 "type": "constrain_child_tools", 129 "prompt_template": "foo", 130 "children": [ 131 "foo" 132 ] 133 } 134 ], 135 "message_ids": [ 136 "foo" 137 ], 138 "response_format": { 139 "type": "text" 140 }, 141 "description": "foo", 142 "metadata": {}, 143 "tool_exec_environment_variables": [ 144 { 145 "key": "foo", 146 "value": "foo", 147 "agent_id": "foo", 148 "created_by_id": "foo", 149 "last_updated_by_id": "foo", 150 "created_at": "foo", 151 "updated_at": "foo", 152 "id": "agent-env-123e4567-e89b-12d3-a456-426614174000", 153 "description": "foo" 154 } 155 ], 156 "project_id": "foo", 157 "template_id": "foo", 158 "base_template_id": "foo", 159 "identity_ids": [ 160 "foo" 161 ], 162 "message_buffer_autoclear": false, 163 "enable_sleeptime": true, 164 "multi_agent_group": { 165 "id": "foo", 166 "manager_type": "round_robin", 167 "agent_ids": [ 168 "foo" 169 ], 170 "description": "foo", 171 "shared_block_ids": [ 172 "foo" 173 ], 174 "manager_agent_id": "foo", 175 "termination_token": "foo", 176 "max_turns": 42, 177 "sleeptime_agent_frequency": 42, 178 "turns_counter": 42, 179 "last_processed_message_id": "foo", 180 "max_message_buffer_length": 42, 181 "min_message_buffer_length": 42 182 } 183 } 184 ]

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

tagslist of stringsOptional

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

limitintegerOptionalDefaults to 50

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

identity_idstringOptional

Search agents by identity ID

identifier_keyslist of stringsOptional

Search agents by identifier keys

include_relationshipslist of stringsOptional

Specify which relational fields (e.g., ‘tools’, ‘sources’, ‘memory’) to include in the response. If not provided, all relationships are loaded by default. Using this can optimize performance by reducing unnecessary joins.

ascendingbooleanOptionalDefaults to false

Whether to sort agents oldest to newest (True) or newest to oldest (False, default)

Response

Successful Response

idstring

The id of the agent. Assigned by the database.

namestring

The name of the agent.

systemstring

The system prompt used by the agent.

agent_typeenum

The type of agent.

llm_configobject

The LLM configuration used by the agent.

embedding_configobject

The embedding configuration used by the agent.

memoryobject

The in-context memory of the agent.

toolslist of objects

The tools used by the agent.

sourceslist of objects

The sources used by the agent.

tagslist of strings

The tags associated with the agent.

created_by_idstring or null

The id of the user that made this object.

last_updated_by_idstring or null

The id of the user that made this object.

created_atstring or nullformat: "date-time"

The timestamp when the object was created.

updated_atstring or nullformat: "date-time"

The timestamp when the object was last updated.

tool_ruleslist of objects or null

The list of tool rules.

message_idslist of strings or null

The ids of the messages in the agent’s in-context memory.

response_formatobject or null

The response format used by the agent when returning from send_message.

descriptionstring or null

The description of the agent.

metadataobject or null

The metadata of the agent.

tool_exec_environment_variableslist of objects or null

The environment variables for tool execution specific to this agent.

project_idstring or null

The id of the project the agent belongs to.

template_idstring or null

The id of the template the agent belongs to.

base_template_idstring or null

The base template id of the agent.

identity_idslist of strings or null

The ids of the identities associated with this agent.

message_buffer_autoclearboolean or nullDefaults to false

If set to True, the agent will not remember previous messages (though the agent will still retain state via core memory blocks and archival/recall memory). Not recommended unless you have an advanced use case.

enable_sleeptimeboolean or null

If set to True, memory management will move to a background agent thread.

multi_agent_groupobject or null

The multi-agent group that this agent manages

Headers

Query parameters

Response