--- title: "Create agents from a template (Cloud-only)" method: POST path: "/v1/templates/{project_id}/{template_version}/agents" tags: ["templates"] --- # Create agents from a template (Cloud-only) `POST /v1/templates/{project_id}/{template_version}/agents` Creates an Agent or multiple Agents from a template ## Path parameters - `project_id` string, required - `template_version` string, required ## Request body - object - `tags` string[] — The tags to assign to the agent - `agent_name` string — The name of the agent, optional otherwise a random one will be assigned - `initial_message_sequence` object[] — Set an initial sequence of messages, if not provided, the agent will start with the default message sequence, if an empty array is provided, the agent will start with no messages - `role` 'user' | 'system' | 'assistant', required - `content` string, required - `name` string, nullable - `otid` string, nullable - `sender_id` string, nullable - `batch_item_id` string, nullable - `group_id` string, nullable - `memory_variables` object — The memory variables to assign to the agent - `tool_variables` object — The tool variables to assign to the agent - `identity_ids` string[] — The identity ids to assign to the agent ## Response `201` 201 - object - `agents` object[], required - `created_by_id` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `last_updated_by_id` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `created_at` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `updated_at` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `id` string, required - `name` string, required - `tool_rules` union - union[] - union - object - `tool_name` string, required - `type` union - … - `prompt_template` union - … - `children` string[], required - `child_arg_nodes` union - … - object - `tool_name` string, required - `type` union - … - `prompt_template` union - … - `args` union - … - object - `tool_name` string, required - `type` union - … - `prompt_template` union - … - object - `tool_name` string, required - `type` union - … - `prompt_template` union - … - `default_child` union - … - `child_output_mapping` unknown - `require_output_mapping` union - … - object - `tool_name` string, required - `type` union - … - `prompt_template` union - … - object - `tool_name` string, required - `type` union - … - `prompt_template` union - … - object - `tool_name` string, required - `type` union - … - `prompt_template` union - … - `max_count_limit` number, required - object - `tool_name` string, required - `type` union - … - `prompt_template` union - … - `children` string[], required - object - `tool_name` string, required - `type` union - … - `prompt_template` union - … - string, null, nullable - union[] - union - union[] - union - … - string, null, nullable - unknown - `message_ids` union - string[] - string, null, nullable - union[] - union - string[] - string, null, nullable - unknown - `system` string, required - `agent_type` 'memgpt_agent' | 'memgpt_v2_agent' | 'letta_v1_agent' | 'react_agent' | 'workflow_agent' | 'split_thread_agent' | 'sleeptime_agent' | 'voice_convo_agent' | 'voice_sleeptime_agent', required - `llm_config` object, required - `model` string, required - `model_endpoint_type` 'openai' | 'anthropic' | 'google_ai' | 'google_vertex' | 'azure' | 'groq' | 'ollama' | 'webui' | 'webui-legacy' | 'lmstudio' | 'lmstudio-legacy' | 'lmstudio-chatcompletions' | 'llamacpp' | 'koboldcpp' | 'vllm' | 'hugging-face' | 'mistral' | 'together' | 'bedrock' | 'deepseek' | 'xai', required - `model_endpoint` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `provider_name` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `provider_category` union - 'base' | 'byok' - string, null, nullable - union[] - union - 'base' | 'byok' - string, null, nullable - unknown - `model_wrapper` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `context_window` number, required - `put_inner_thoughts_in_kwargs` union - boolean - string, null, nullable - union[] - union - boolean - string, null, nullable - unknown - `handle` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `temperature` union - number - unknown - `max_tokens` union - number - string, null, nullable - union[] - union - number - string, null, nullable - unknown - `enable_reasoner` union - boolean - unknown - `reasoning_effort` union - 'minimal' - 'low' - 'medium' - 'high' - string, null, nullable - union[] - union - 'minimal' - 'low' - 'medium' - 'high' - string, null, nullable - unknown - `max_reasoning_tokens` union - number - unknown - `frequency_penalty` union - number - string, null, nullable - union[] - union - number - string, null, nullable - unknown - `compatibility_type` union - 'gguf' - 'mlx' - string, null, nullable - union[] - union - 'gguf' - 'mlx' - string, null, nullable - unknown - `verbosity` union - 'low' - 'medium' - 'high' - string, null, nullable - union[] - union - 'low' - 'medium' - 'high' - string, null, nullable - unknown - `tier` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `embedding_config` object, required - `embedding_endpoint_type` 'openai' | 'anthropic' | 'bedrock' | 'google_ai' | 'google_vertex' | 'azure' | 'groq' | 'ollama' | 'webui' | 'webui-legacy' | 'lmstudio' | 'lmstudio-legacy' | 'llamacpp' | 'koboldcpp' | 'vllm' | 'hugging-face' | 'mistral' | 'together' | 'pinecone', required - `embedding_endpoint` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `embedding_model` string, required - `embedding_dim` number, required - `embedding_chunk_size` union - number - string, null, nullable - union[] - union - number - string, null, nullable - unknown - `handle` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `batch_size` union - number - unknown - `azure_endpoint` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `azure_version` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `azure_deployment` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `response_format` union - object - `type` string - object - `type` union - string - unknown - `json_schema` unknown - object - `type` string - string, null, nullable - union[] - union - object - `type` string - object - `type` union - … - `json_schema` unknown - object - `type` string - string, null, nullable - unknown - `description` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `metadata` union - unknown - string, null, nullable - union[] - union - unknown - string, null, nullable - unknown - `memory` object, required - `agent_type` union - 'memgpt_agent' | 'memgpt_v2_agent' | 'letta_v1_agent' | 'react_agent' | 'workflow_agent' | 'split_thread_agent' | 'sleeptime_agent' | 'voice_convo_agent' | 'voice_sleeptime_agent' - string - string, null, nullable - union[] - union - 'memgpt_agent' | 'memgpt_v2_agent' | 'letta_v1_agent' | 'react_agent' | 'workflow_agent' | 'split_thread_agent' | 'sleeptime_agent' | 'voice_convo_agent' | 'voice_sleeptime_agent' - string - string, null, nullable - unknown - `blocks` object[], required - `value` string, required - `limit` union - number - unknown - `project_id` union - string - string, null, nullable - union[] - union - … - unknown - `name` union - string - string, null, nullable - union[] - union - … - unknown - `is_template` union - boolean - unknown - `base_template_id` union - string - string, null, nullable - union[] - union - … - unknown - `deployment_id` union - string - string, null, nullable - union[] - union - … - unknown - `entity_id` union - string - string, null, nullable - union[] - union - … - unknown - `preserve_on_migration` union - boolean - string, null, nullable - union[] - union - … - unknown - `label` union - string - string, null, nullable - union[] - union - … - unknown - `read_only` union - boolean - unknown - `description` union - string - string, null, nullable - union[] - union - … - unknown - `metadata` union - unknown - string, null, nullable - union[] - union - … - unknown - `hidden` union - boolean - string, null, nullable - union[] - union - … - unknown - `id` union - string - unknown - `created_by_id` union - string - string, null, nullable - union[] - union - … - unknown - `last_updated_by_id` union - string - string, null, nullable - union[] - union - … - unknown - `file_blocks` union - object[] - `value` string, required - `limit` union - number - unknown - `project_id` union - string - string, null, nullable - union[] - … - unknown - `name` union - string - string, null, nullable - union[] - … - unknown - `is_template` union - boolean - unknown - `base_template_id` union - string - string, null, nullable - union[] - … - unknown - `deployment_id` union - string - string, null, nullable - union[] - … - unknown - `entity_id` union - string - string, null, nullable - union[] - … - unknown - `preserve_on_migration` union - boolean - string, null, nullable - union[] - … - unknown - `label` union - string - string, null, nullable - union[] - … - unknown - `read_only` union - boolean - unknown - `description` union - string - string, null, nullable - union[] - … - unknown - `metadata` union - unknown - string, null, nullable - union[] - … - unknown - `hidden` union - boolean - string, null, nullable - union[] - … - unknown - `id` union - string - unknown - `created_by_id` union - string - string, null, nullable - union[] - … - unknown - `last_updated_by_id` union - string - string, null, nullable - union[] - … - unknown - `file_id` string, required - `source_id` string, required - `is_open` boolean, required - `last_accessed_at` union - string - string, null, nullable - union[] - … - unknown - unknown - `prompt_template` union - string - unknown - `tools` object[], required - `id` string - `tool_type` 'custom' | 'letta_core' | 'letta_memory_core' | 'letta_multi_agent_core' | 'letta_sleeptime_core' | 'letta_voice_sleeptime_core' | 'letta_builtin' | 'letta_files_core' | 'external_langchain' | 'external_composio' | 'external_mcp' - `description` union - string - string, null, nullable - union[] - union - string - string, null, nullable - `source_type` union - string - string, null, nullable - union[] - union - string - string, null, nullable - `name` union - string - string, null, nullable - union[] - union - string - string, null, nullable - `tags` string[] - `source_code` union - string - string, null, nullable - union[] - union - string - string, null, nullable - `json_schema` union - unknown - string, null, nullable - union[] - union - unknown - string, null, nullable - `args_json_schema` union - unknown - string, null, nullable - union[] - union - unknown - string, null, nullable - `return_char_limit` number - `pip_requirements` union - object[] - `name` string, required - `version` union - string - string, null, nullable - union[] - … - unknown - string, null, nullable - union[] - union - object[] - … - string, null, nullable - `npm_requirements` union - object[] - `name` string, required - `version` union - string - string, null, nullable - union[] - … - unknown - string, null, nullable - union[] - union - object[] - … - string, null, nullable - `default_requires_approval` union - boolean - string, null, nullable - union[] - union - boolean - string, null, nullable - `created_by_id` union - string - string, null, nullable - union[] - union - string - string, null, nullable - `last_updated_by_id` union - string - string, null, nullable - union[] - union - string - string, null, nullable - `metadata_` union - unknown - string, null, nullable - union[] - union - unknown - string, null, nullable - `sources` object[], required - `name` string, required - `description` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `instructions` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `metadata` union - unknown - string, null, nullable - union[] - union - unknown - string, null, nullable - unknown - `id` union - string - unknown - `embedding_config` object, required - `embedding_endpoint_type` 'openai' | 'anthropic' | 'bedrock' | 'google_ai' | 'google_vertex' | 'azure' | 'groq' | 'ollama' | 'webui' | 'webui-legacy' | 'lmstudio' | 'lmstudio-legacy' | 'llamacpp' | 'koboldcpp' | 'vllm' | 'hugging-face' | 'mistral' | 'together' | 'pinecone', required - `embedding_endpoint` union - string - string, null, nullable - union[] - union - … - unknown - `embedding_model` string, required - `embedding_dim` number, required - `embedding_chunk_size` union - number - string, null, nullable - union[] - union - … - unknown - `handle` union - string - string, null, nullable - union[] - union - … - unknown - `batch_size` union - number - unknown - `azure_endpoint` union - string - string, null, nullable - union[] - union - … - unknown - `azure_version` union - string - string, null, nullable - union[] - union - … - unknown - `azure_deployment` union - string - string, null, nullable - union[] - union - … - unknown - `organization_id` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `vector_db_provider` union - 'native' | 'tpuf' | 'pinecone' - unknown - `created_by_id` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `last_updated_by_id` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `created_at` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `updated_at` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `tags` string[], required - `tool_exec_environment_variables` union - object[] - `created_by_id` union - string - string, null, nullable - union[] - union - … - unknown - `last_updated_by_id` union - string - string, null, nullable - union[] - union - … - unknown - `created_at` union - string - string, null, nullable - union[] - union - … - unknown - `updated_at` union - string - string, null, nullable - union[] - union - … - unknown - `id` union - string - unknown - `key` string, required - `value` string, required - `description` union - string - string, null, nullable - union[] - union - … - unknown - `organization_id` union - string - string, null, nullable - union[] - union - … - unknown - `value_enc` union - string - string, null, nullable - string, null, nullable - union[] - union - … - unknown - `agent_id` string, required - unknown - `secrets` union - object[] - `created_by_id` union - string - string, null, nullable - union[] - union - … - unknown - `last_updated_by_id` union - string - string, null, nullable - union[] - union - … - unknown - `created_at` union - string - string, null, nullable - union[] - union - … - unknown - `updated_at` union - string - string, null, nullable - union[] - union - … - unknown - `id` union - string - unknown - `key` string, required - `value` string, required - `description` union - string - string, null, nullable - union[] - union - … - unknown - `organization_id` union - string - string, null, nullable - union[] - union - … - unknown - `value_enc` union - string - string, null, nullable - string, null, nullable - union[] - union - … - unknown - `agent_id` string, required - unknown - `project_id` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `template_id` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `base_template_id` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `deployment_id` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `entity_id` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `identity_ids` union - string[] - unknown - `message_buffer_autoclear` union - boolean - unknown - `enable_sleeptime` union - boolean - string, null, nullable - union[] - union - boolean - string, null, nullable - unknown - `multi_agent_group` union - object - `id` string, required - `manager_type` 'round_robin' | 'supervisor' | 'dynamic' | 'sleeptime' | 'voice_sleeptime' | 'swarm', required - `agent_ids` string[], required - `description` string, required - `project_id` union - string - string, null, nullable - union[] - union - … - unknown - `template_id` union - string - string, null, nullable - union[] - union - … - unknown - `base_template_id` union - string - string, null, nullable - union[] - union - … - unknown - `deployment_id` union - string - string, null, nullable - union[] - union - … - unknown - `shared_block_ids` union - string[] - unknown - `manager_agent_id` union - string - string, null, nullable - union[] - union - … - unknown - `termination_token` union - string - string, null, nullable - union[] - union - … - unknown - `max_turns` union - number - string, null, nullable - union[] - union - … - unknown - `sleeptime_agent_frequency` union - number - string, null, nullable - union[] - union - … - unknown - `turns_counter` union - number - string, null, nullable - union[] - union - … - unknown - `last_processed_message_id` union - string - string, null, nullable - union[] - union - … - unknown - `max_message_buffer_length` union - number - string, null, nullable - union[] - union - … - unknown - `min_message_buffer_length` union - number - string, null, nullable - union[] - union - … - unknown - `hidden` union - boolean - string, null, nullable - union[] - union - … - unknown - string, null, nullable - union[] - union - object - `id` string, required - `manager_type` 'round_robin' | 'supervisor' | 'dynamic' | 'sleeptime' | 'voice_sleeptime' | 'swarm', required - `agent_ids` string[], required - `description` string, required - `project_id` union - … - `template_id` union - … - `base_template_id` union - … - `deployment_id` union - … - `shared_block_ids` union - … - `manager_agent_id` union - … - `termination_token` union - … - `max_turns` union - … - `sleeptime_agent_frequency` union - … - `turns_counter` union - … - `last_processed_message_id` union - … - `max_message_buffer_length` union - … - `min_message_buffer_length` union - … - `hidden` union - … - string, null, nullable - unknown - `last_run_completion` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `last_run_duration_ms` union - number - string, null, nullable - union[] - union - number - string, null, nullable - unknown - `timezone` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `max_files_open` union - number - string, null, nullable - union[] - union - number - string, null, nullable - unknown - `per_file_view_window_char_limit` union - number - string, null, nullable - union[] - union - number - string, null, nullable - unknown - `hidden` union - boolean - string, null, nullable - union[] - union - boolean - string, null, nullable - unknown - `group` object, nullable - `id` string, required - `manager_type` 'round_robin' | 'supervisor' | 'dynamic' | 'sleeptime' | 'voice_sleeptime' | 'swarm', required - `agent_ids` string[], required - `description` string, required - `project_id` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `template_id` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `base_template_id` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `deployment_id` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `shared_block_ids` union - string[] - unknown - `manager_agent_id` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `termination_token` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `max_turns` union - number - string, null, nullable - union[] - union - number - string, null, nullable - unknown - `sleeptime_agent_frequency` union - number - string, null, nullable - union[] - union - number - string, null, nullable - unknown - `turns_counter` union - number - string, null, nullable - union[] - union - number - string, null, nullable - unknown - `last_processed_message_id` union - string - string, null, nullable - union[] - union - string - string, null, nullable - unknown - `max_message_buffer_length` union - number - string, null, nullable - union[] - union - number - string, null, nullable - unknown - `min_message_buffer_length` union - number - string, null, nullable - union[] - union - number - string, null, nullable - unknown - `hidden` union - boolean - string, null, nullable - union[] - union - boolean - string, null, nullable - unknown - `deployment_id` string, required — The deployment ID of the created agents, group and blocks, can be used to identify from a specific invokation ## Other responses - `402` — 402 ## Changes - **2025-10-09** `6cec99480c13` — 2 info - added the optional property `agents/items/secrets/oneOf[subschema #1]/items/value_enc` to the response with the `201` status - added the optional property `agents/items/tool_exec_environment_variables/oneOf[subschema #1]/items/value_enc` to the response with the `201` status - **2025-10-01** `17b1c4a59276` — 1 breaking, 1 info - added `subschema #1, subschema #3` to the `agents/items/tool_rules` response property `oneOf` list for the response status `201` - removed `subschema #1, subschema #3` from the `agents/items/tool_rules` response property `oneOf` list for the response status `201` - **2025-10-01** `05c8e12a3c8f` — 1 breaking, 1 info - added `subschema #1, subschema #3` to the `agents/items/tool_rules` response property `oneOf` list for the response status `201` - removed `subschema #1, subschema #3` from the `agents/items/tool_rules` response property `oneOf` list for the response status `201` - **2025-10-01** `4d0fc5930af2` — 1 breaking, 1 info - added `subschema #1, subschema #3` to the `agents/items/tool_rules` response property `oneOf` list for the response status `201` - removed `subschema #1, subschema #3` from the `agents/items/tool_rules` response property `oneOf` list for the response status `201` - …earlier changes not shown [Full history](https://skmtc.dev/yu-code666/apis/letta-api/changes/v1/templates/:project_id/:template_version/agents/post.md) --- [API](https://skmtc.dev/yu-code666/apis/letta-api.md) · [All operations](https://skmtc.dev/yu-code666/apis/letta-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/yu-code666/letta-api/revisions/6cec99480c13/schema)