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             "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         "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 %}"
52       },
53       "tools": [
54         {
55           "id": "tool-123e4567-e89b-12d3-a456-426614174000",
56           "tool_type": "custom",
57           "description": "foo",
58           "source_type": "foo",
59           "name": "foo",
60           "tags": [
61             "foo"
62           ],
63           "source_code": "foo",
64           "json_schema": {},
65           "args_json_schema": {},
66           "return_char_limit": 6000,
67           "created_by_id": "foo",
68           "last_updated_by_id": "foo",
69           "metadata_": {}
70         }
71       ],
72       "sources": [
73         {
74           "name": "foo",
75           "embedding_config": {
76             "embedding_endpoint_type": "openai",
77             "embedding_model": "foo",
78             "embedding_dim": 42,
79             "embedding_endpoint": "foo",
80             "embedding_chunk_size": 42,
81             "handle": "foo",
82             "azure_endpoint": "foo",
83             "azure_version": "foo",
84             "azure_deployment": "foo"
85           },
86           "id": "source-123e4567-e89b-12d3-a456-426614174000",
87           "description": "foo",
88           "instructions": "foo",
89           "metadata": {},
90           "created_by_id": "foo",
91           "last_updated_by_id": "foo",
92           "created_at": "foo",
93           "updated_at": "foo"
94         }
95       ],
96       "tags": [
97         "foo"
98       ],
99       "created_by_id": "foo",
100       "last_updated_by_id": "foo",
101       "created_at": "foo",
102       "updated_at": "foo",
103       "tool_rules": [
104         {
105           "tool_name": "foo",
106           "type": "constrain_child_tools",
107           "children": [
108             "foo"
109           ]
110         }
111       ],
112       "message_ids": [
113         "foo"
114       ],
115       "response_format": {
116         "type": "text"
117       },
118       "description": "foo",
119       "metadata": {},
120       "tool_exec_environment_variables": [
121         {
122           "key": "foo",
123           "value": "foo",
124           "agent_id": "foo",
125           "created_by_id": "foo",
126           "last_updated_by_id": "foo",
127           "created_at": "foo",
128           "updated_at": "foo",
129           "id": "agent-env-123e4567-e89b-12d3-a456-426614174000",
130           "description": "foo"
131         }
132       ],
133       "project_id": "foo",
134       "template_id": "foo",
135       "base_template_id": "foo",
136       "identity_ids": [
137         "foo"
138       ],
139       "message_buffer_autoclear": false,
140       "enable_sleeptime": true,
141       "multi_agent_group": {
142         "id": "foo",
143         "manager_type": "round_robin",
144         "agent_ids": [
145           "foo"
146         ],
147         "description": "foo",
148         "shared_block_ids": [
149           "foo"
150         ],
151         "manager_agent_id": "foo",
152         "termination_token": "foo",
153         "max_turns": 42,
154         "sleeptime_agent_frequency": 42,
155         "turns_counter": 42,
156         "last_processed_message_id": "foo",
157         "max_message_buffer_length": 42,
158         "min_message_buffer_length": 42
159       }
160     }
161   ],
162   "nextCursor": "foo"
163 }

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