Create Agents From Template

post/v1/templates/{template_version}/agents

Creates an Agent or multiple Agents from a template

Path ParametersExpand Collapse

template_version: string

Body ParametersExpand Collapse

agent_name: optional string

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

identity_ids: optional array of string

The identity ids to assign to the agent

initial_message_sequence: optional array of object { content, role, batch_item_id, 4 more }

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

content: string

role: "user" or "system" or "assistant"

Accepts one of the following:

"user"

"system"

"assistant"

batch_item_id: optional string

group_id: optional string

name: optional string

otid: optional string

sender_id: optional string

memory_variables: optional map[string]

The memory variables to assign to the agent

tags: optional array of string

The tags to assign to the agent

tool_variables: optional map[string]

The tool variables to assign to the agent

ReturnsExpand Collapse

agent_ids: array of string

Array of created agent IDs

deployment_id: string

The deployment ID for the created agents

group_id: string

Optional group ID if agents were created in a group

Create Agents From Template

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

{
  "agent_ids": [
    "string"
  ],
  "deployment_id": "deployment_id",
  "group_id": "group_id"
}

Returns Examples

{
  "agent_ids": [
    "string"
  ],
  "deployment_id": "deployment_id",
  "group_id": "group_id"
}