Create template (Cloud-only)

post/v1/templates

Creates a new template from an existing agent or agent file

Body ParametersExpand Collapse

body: optional object { agent_id, type, name } or object { agent_file, type, name, update_existing_tools }

The type of template to create, currently only agent templates are supported

Accepts one of the following:

Agent = object { agent_id, type, name }

Create a template from an existing agent

agent_id: string

The ID of the agent to use as a template, can be from any project

type: "agent"

Accepts one of the following:

"agent"

Optional custom name for the template. If not provided, a random name will be generated.

AgentFile = object { agent_file, type, name, update_existing_tools }

Create a template from an uploaded agent file

agent_file: map[unknown]

The agent file to use as a template, this should be a JSON file exported from the platform

type: "agent_file"

Accepts one of the following:

"agent_file"

Optional custom name for the template. If not provided, a random name will be generated.

update_existing_tools: optional boolean

If true, update existing custom tools source_code and json_schema (source_type cannot be changed)

ReturnsExpand Collapse

id: string

latest_version: string

The latest version of the template

The exact name of the template

project_id: string

project_slug: string

template_deployment_slug: string

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

updated_at: string

When the template was last updated

description: optional string

Create template (Cloud-only)

curl https://api.letta.com/v1/templates \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $LETTA_API_KEY"

{
  "id": "id",
  "latest_version": "latest_version",
  "name": "name",
  "project_id": "project_id",
  "project_slug": "project_slug",
  "template_deployment_slug": "template_deployment_slug",
  "updated_at": "updated_at",
  "description": "description"
}

Returns Examples

{
  "id": "id",
  "latest_version": "latest_version",
  "name": "name",
  "project_id": "project_id",
  "project_slug": "project_slug",
  "template_deployment_slug": "template_deployment_slug",
  "updated_at": "updated_at",
  "description": "description"
}