Skip to content
Letta Letta Letta Docs
Sign up
API Reference

Templates

Create template (Cloud-only)
templates.create(TemplateCreateParams**kwargs) -> TemplateCreateResponse
POST/v1/templates
Save template version (Cloud-only)
templates.save(strtemplate_name, TemplateSaveParams**kwargs) -> TemplateSaveResponse
POST/v1/templates/{template_name}/save
Delete template (Cloud-only)
templates.delete(strtemplate_name) -> TemplateDeleteResponse
DELETE/v1/templates/{template_name}
Update current template from agent file (Cloud-only)
templates.update(strtemplate_name, TemplateUpdateParams**kwargs) -> TemplateUpdateResponse
PATCH/v1/templates/{template_name}
Rollback template to previous version (Cloud-only)
templates.rollback(strtemplate_name, TemplateRollbackParams**kwargs) -> TemplateRollbackResponse
POST/v1/templates/{template_name}/rollback
ModelsExpand Collapse
class TemplateCreateResponse: …
id: str
latest_version: str

The latest version of the template

name: str

The exact name of the template

project_id: str
project_slug: str
template_deployment_slug: str

The full name of the template, including version and project slug

updated_at: str

When the template was last updated

description: Optional[str]
class TemplateSaveResponse: …
id: str
latest_version: str

The latest version of the template

name: str

The exact name of the template

project_id: str
project_slug: str
template_deployment_slug: str

The full name of the template, including version and project slug

updated_at: str

When the template was last updated

description: Optional[str]
class TemplateDeleteResponse: …
success: bool
class TemplateUpdateResponse: …
success: bool
message: Optional[str]
class TemplateRollbackResponse: …
success: bool
message: Optional[str]

TemplatesAgents

Create Agents From Template
templates.agents.create(strtemplate_version, AgentCreateParams**kwargs) -> AgentCreateResponse
POST/v1/templates/{template_version}/agents
ModelsExpand Collapse
class AgentCreateResponse: …

Response containing created agent IDs and associated metadata

agent_ids: List[str]

Array of created agent IDs

deployment_id: str

The deployment ID for the created agents

group_id: Optional[str]

Optional group ID if agents were created in a group