Create agents from a template (Cloud-only)

POST

/v1/templates/:project/:template_version/agents

POST

/v1/templates/:project/:template_version/agents

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

Try it

201

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         "batch_size": 32,
32         "azure_endpoint": "foo",
33         "azure_version": "foo",
34         "azure_deployment": "foo"
35       },
36       "memory": {
37         "blocks": [
38           {
39             "value": "foo",
40             "limit": 5000,
41             "name": "foo",
42             "is_template": false,
43             "preserve_on_migration": true,
44             "label": "foo",
45             "read_only": false,
46             "description": "foo",
47             "metadata": {},
48             "id": "block-123e4567-e89b-12d3-a456-426614174000",
49             "created_by_id": "foo",
50             "last_updated_by_id": "foo"
51           }
52         ],
53         "file_blocks": [
54           {
55             "value": "foo",
56             "limit": 5000,
57             "name": "foo",
58             "is_template": false,
59             "preserve_on_migration": true,
60             "label": "foo",
61             "read_only": false,
62             "description": "foo",
63             "metadata": {},
64             "id": "block-123e4567-e89b-12d3-a456-426614174000",
65             "created_by_id": "foo",
66             "last_updated_by_id": "foo"
67           }
68         ],
69         "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 %}"
70       },
71       "tools": [
72         {
73           "id": "tool-123e4567-e89b-12d3-a456-426614174000",
74           "tool_type": "custom",
75           "description": "foo",
76           "source_type": "foo",
77           "name": "foo",
78           "tags": [
79             "foo"
80           ],
81           "source_code": "foo",
82           "json_schema": {},
83           "args_json_schema": {},
84           "return_char_limit": 6000,
85           "pip_requirements": [
86             {
87               "name": "foo",
88               "version": "foo"
89             }
90           ],
91           "created_by_id": "foo",
92           "last_updated_by_id": "foo",
93           "metadata_": {}
94         }
95       ],
96       "sources": [
97         {
98           "name": "foo",
99           "embedding_config": {
100             "embedding_endpoint_type": "openai",
101             "embedding_model": "foo",
102             "embedding_dim": 42,
103             "embedding_endpoint": "foo",
104             "embedding_chunk_size": 42,
105             "handle": "foo",
106             "batch_size": 32,
107             "azure_endpoint": "foo",
108             "azure_version": "foo",
109             "azure_deployment": "foo"
110           },
111           "id": "source-123e4567-e89b-12d3-a456-426614174000",
112           "description": "foo",
113           "instructions": "foo",
114           "metadata": {},
115           "created_by_id": "foo",
116           "last_updated_by_id": "foo",
117           "created_at": "foo",
118           "updated_at": "foo"
119         }
120       ],
121       "tags": [
122         "foo"
123       ],
124       "created_by_id": "foo",
125       "last_updated_by_id": "foo",
126       "created_at": "foo",
127       "updated_at": "foo",
128       "tool_rules": [
129         {
130           "tool_name": "foo",
131           "type": "constrain_child_tools",
132           "prompt_template": "foo",
133           "children": [
134             "foo"
135           ]
136         }
137       ],
138       "message_ids": [
139         "foo"
140       ],
141       "response_format": {
142         "type": "text"
143       },
144       "description": "foo",
145       "metadata": {},
146       "tool_exec_environment_variables": [
147         {
148           "key": "foo",
149           "value": "foo",
150           "agent_id": "foo",
151           "created_by_id": "foo",
152           "last_updated_by_id": "foo",
153           "created_at": "foo",
154           "updated_at": "foo",
155           "id": "agent-env-123e4567-e89b-12d3-a456-426614174000",
156           "description": "foo"
157         }
158       ],
159       "project_id": "foo",
160       "template_id": "foo",
161       "base_template_id": "foo",
162       "identity_ids": [
163         "foo"
164       ],
165       "message_buffer_autoclear": false,
166       "enable_sleeptime": true,
167       "multi_agent_group": {
168         "id": "foo",
169         "manager_type": "round_robin",
170         "agent_ids": [
171           "foo"
172         ],
173         "description": "foo",
174         "shared_block_ids": [
175           "foo"
176         ],
177         "manager_agent_id": "foo",
178         "termination_token": "foo",
179         "max_turns": 42,
180         "sleeptime_agent_frequency": 42,
181         "turns_counter": 42,
182         "last_processed_message_id": "foo",
183         "max_message_buffer_length": 42,
184         "min_message_buffer_length": 42
185       },
186       "last_run_completion": "foo",
187       "last_run_duration_ms": 42,
188       "timezone": "foo"
189     }
190   ]
191 }

Creates an Agent or multiple Agents from a template

Path parameters

projectstringRequired

The project slug

template_versionstringRequired

The template version, formatted as {template-name}:{version-number} or {template-name}:latest

Request

Body

tagslist of stringsOptional

The tags to assign to the agent

agent_namestringOptional

The name of the agent, optional otherwise a random one will be assigned

memory_variablesmap from strings to stringsOptional

The memory variables to assign to the agent

tool_variablesmap from strings to stringsOptional

The tool variables to assign to the agent

identity_idslist of stringsOptional

The identity ids to assign to the agent

Response

201

agentslist of objects

Path parameters

Headers

Request

Response