Search Deployed Agents

POST

/v1/agents/search

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

POST

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

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.1
12       },
13       "embedding_config": {
14         "embedding_endpoint_type": "openai",
15         "embedding_model": "embedding_model",
16         "embedding_dim": 1.1
17       },
18       "memory": {
19         "blocks": [
20           {
21             "value": "value"
22           }
23         ]
24       },
25       "tools": [
26         {}
27       ],
28       "sources": [
29         {
30           "name": "name",
31           "embedding_config": {
32             "embedding_endpoint_type": "openai",
33             "embedding_model": "embedding_model",
34             "embedding_dim": 1.1
35           }
36         }
37       ],
38       "tags": [
39         "tags"
40       ],
41       "created_by_id": "created_by_id",
42       "last_updated_by_id": "last_updated_by_id",
43       "created_at": "created_at",
44       "updated_at": "updated_at",
45       "tool_rules": [
46         {
47           "tool_name": "tool_name",
48           "children": [
49             "children"
50           ]
51         }
52       ],
53       "message_ids": [
54         "message_ids"
55       ],
56       "organization_id": "organization_id",
57       "description": "description",
58       "metadata": "metadata",
59       "tool_exec_environment_variables": [
60         {
61           "key": "key",
62           "value": "value",
63           "agent_id": "agent_id"
64         }
65       ],
66       "project_id": "project_id",
67       "template_id": "template_id",
68       "base_template_id": "base_template_id",
69       "identity_ids": [
70         "identity_ids"
71       ],
72       "message_buffer_autoclear": true,
73       "template": "template"
74     }
75   ],
76   "nextCursor": "nextCursor"
77 }

Retrieve Agent Context Window

Up Next

Built with

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

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.1
12	},
13	"embedding_config": {
14	"embedding_endpoint_type": "openai",
15	"embedding_model": "embedding_model",
16	"embedding_dim": 1.1
17	},
18	"memory": {
19	"blocks": [
20	{
21	"value": "value"
22	}
23	]
24	},
25	"tools": [
26	{}
27	],
28	"sources": [
29	{
30	"name": "name",
31	"embedding_config": {
32	"embedding_endpoint_type": "openai",
33	"embedding_model": "embedding_model",
34	"embedding_dim": 1.1
35	}
36	}
37	],
38	"tags": [
39	"tags"
40	],
41	"created_by_id": "created_by_id",
42	"last_updated_by_id": "last_updated_by_id",
43	"created_at": "created_at",
44	"updated_at": "updated_at",
45	"tool_rules": [
46	{
47	"tool_name": "tool_name",
48	"children": [
49	"children"
50	]
51	}
52	],
53	"message_ids": [
54	"message_ids"
55	],
56	"organization_id": "organization_id",
57	"description": "description",
58	"metadata": "metadata",
59	"tool_exec_environment_variables": [
60	{
61	"key": "key",
62	"value": "value",
63	"agent_id": "agent_id"
64	}
65	],
66	"project_id": "project_id",
67	"template_id": "template_id",
68	"base_template_id": "base_template_id",
69	"identity_ids": [
70	"identity_ids"
71	],
72	"message_buffer_autoclear": true,
73	"template": "template"
74	}
75	],
76	"nextCursor": "nextCursor"
77	}