Search Deployed Agents

POST

/v1/agents/search

POST

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

Try it

200Successful

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

This endpoint is only available on Letta Cloud.

Search deployed agents.

Request

This endpoint expects an object.

searchlist of objectsOptional

project_idstringOptional

combinator"AND"OptionalDefaults to AND

limitdoubleOptional

afterstringOptional

Response

200

agentslist of objects

nextCursorstringOptional

Headers

Request

Response