Search Deployed Agents

POST

/v1/agents/search

POST

/v1/agents/search

1 curl -X POST https://api.letta.com/v1/agents/search \
2      -H "Authorization: Bearer <token>" \
3      -H "Content-Type: application/json" \
4      -d '{}'

Try it

200

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

This endpoint is only available on Letta Cloud.

Search deployed agents.

Request

Body

searchlist of objectsOptional

project_idstringOptional

combinatorenumOptional

Allowed values:

limitintegerOptional

afterstringOptional

Response

200

agentslist of objects

nextCursorstringOptional

Headers

Request

Response