Create Agent Version - MemoryLake AI

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/api/v3/agents/agt_r8k2m1n3/versions' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-4o",
    "capabilities": ["tool_use", "memory_read", "memory_write"],
    "policies": {
      "max_turns": 25,
      "max_tool_calls": 15
    },
    "skills": [
      {
        "skill_id": "skl_kb_search",
        "skill_version": 3
      }
    ],
    "model_settings": {
      "temperature": 0.5,
      "max_tokens": 8192
    }
  }'

{
  "success": true,
  "data": {
    "version": 4,
    "model": "gpt-4o",
    "capabilities": ["tool_use", "memory_read", "memory_write"],
    "policies": {
      "max_turns": 25,
      "max_tool_calls": 15,
      "allow_tools": ["search_kb", "create_ticket"],
      "deny_tools": [],
      "subagent_timeout": 300,
      "subagent_max_concurrency": 3
    },
    "output": {
      "mode": "text",
      "json_schema": null
    },
    "subagents": [
      {
        "name": "ticket-creator",
        "mode": "delegate",
        "context": "Create support tickets from conversation context",
        "inherit_tools": false
      }
    ],
    "skills": [
      {
        "skill_id": "skl_kb_search",
        "skill_version": 3
      }
    ],
    "agent_id": "agt_r8k2m1n3",
    "system_prompt": "You are a helpful support assistant. Use the knowledge base to answer questions accurately.",
    "model_settings": {
      "temperature": 0.5,
      "max_tokens": 8192
    },
    "runtime_bindings": {
      "knowledge_base": "kb_prod_docs"
    },
    "created_at": "2025-05-15T10:00:00Z"
  }
}

POST /openapi/memorylake/api/v3/agents/{id}/versions

Creates a new version of the specified agent. The new version uses merge semantics: only the fields you supply override the previous version’s values. Omitted fields carry forward from the current version unchanged. This is how you update an agent’s model, capabilities, policies, subagents, skills, system prompt, and other configuration. The agent’s version field automatically advances to the newly created version.

Permission required: agent:version_create

Path Parameters

string

required

Agent identifier

Request Body

All fields are optional. Only supplied fields override the previous version.

model

string

Model to use for this version

capabilities

array

Updated list of capability identifiers

policies

object

Updated execution policies

Show Policies object

policies.max_turns

integer

Maximum number of conversation turns per run

policies.max_tool_calls

integer

Maximum number of tool calls per turn

policies.allow_tools

array

Allowlist of tool names the agent may invoke

policies.deny_tools

array

Denylist of tool names the agent must not invoke

policies.subagent_timeout

integer

Maximum seconds a subagent may run before being cancelled

policies.subagent_max_concurrency

integer

Maximum number of subagents that may run concurrently

output

object

Updated output configuration

Show Output object

output.mode

string

Output mode (text or json)

output.json_schema

object

JSON Schema that the agent’s output must conform to when mode is json

subagents

array

Updated subagent definitions

Show Subagent object

subagents[].name

string

Subagent name

subagents[].mode

string

Execution mode for the subagent

subagents[].context

string

Context instructions passed to the subagent

subagents[].inherit_tools

boolean

Whether the subagent inherits the parent agent’s tools

skills

array

Updated skill references

Show Skill reference

skills[].skill_id

string

Skill identifier

skills[].skill_version

integer

Skill version number

system_prompt

string

Updated system prompt

model_settings

object

Updated model-specific settings

runtime_bindings

object

Updated runtime binding configuration

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/api/v3/agents/agt_r8k2m1n3/versions' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-4o",
    "capabilities": ["tool_use", "memory_read", "memory_write"],
    "policies": {
      "max_turns": 25,
      "max_tool_calls": 15
    },
    "skills": [
      {
        "skill_id": "skl_kb_search",
        "skill_version": 3
      }
    ],
    "model_settings": {
      "temperature": 0.5,
      "max_tokens": 8192
    }
  }'

Response

data

object

Show Agent version object

version

integer

Version number of the newly created version

model

string

Model used in this version

capabilities

array

List of capability identifiers

policies

object

Execution policies for this version

Show Policies object

max_turns

integer

Maximum number of conversation turns per run

max_tool_calls

integer

Maximum number of tool calls per turn

allow_tools

array

Allowlist of tool names the agent may invoke

deny_tools

array

Denylist of tool names the agent must not invoke

subagent_timeout

integer

Maximum seconds a subagent may run before being cancelled

subagent_max_concurrency

integer

Maximum number of subagents that may run concurrently

output

object

Output configuration for this version

Show Output object

mode

string

Output mode

json_schema

object

JSON Schema for structured output

subagents

array

Subagent definitions in this version

Show Subagent object

name

string

Subagent name

mode

string

Execution mode for the subagent

context

string

Context instructions passed to the subagent

inherit_tools

boolean

Whether the subagent inherits the parent agent’s tools

skills

array

Skills in this version

Show Skill reference

skill_id

string

Skill identifier

skill_version

integer

Skill version number

agent_id

string

Parent agent identifier

system_prompt

string

System prompt used in this version

model_settings

object

Model-specific settings for this version

runtime_bindings

object

Runtime binding configuration for this version

created_at

string

Version creation timestamp

{
  "success": true,
  "data": {
    "version": 4,
    "model": "gpt-4o",
    "capabilities": ["tool_use", "memory_read", "memory_write"],
    "policies": {
      "max_turns": 25,
      "max_tool_calls": 15,
      "allow_tools": ["search_kb", "create_ticket"],
      "deny_tools": [],
      "subagent_timeout": 300,
      "subagent_max_concurrency": 3
    },
    "output": {
      "mode": "text",
      "json_schema": null
    },
    "subagents": [
      {
        "name": "ticket-creator",
        "mode": "delegate",
        "context": "Create support tickets from conversation context",
        "inherit_tools": false
      }
    ],
    "skills": [
      {
        "skill_id": "skl_kb_search",
        "skill_version": 3
      }
    ],
    "agent_id": "agt_r8k2m1n3",
    "system_prompt": "You are a helpful support assistant. Use the knowledge base to answer questions accurately.",
    "model_settings": {
      "temperature": 0.5,
      "max_tokens": 8192
    },
    "runtime_bindings": {
      "knowledge_base": "kb_prod_docs"
    },
    "created_at": "2025-05-15T10:00:00Z"
  }
}

List Agent Versions Get Agent Version

​Path Parameters

​Request Body

​Response

Path Parameters

Request Body

Response