Create Agent Version

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/api/v3/agents/agent-f8bf71ab17ed8eccad8c0e8ae708273f/versions' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-4o",
    "capabilities": {"web_search": {"open_datasets": ["research/academic"]}},
    "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": {"web_search": {"max_results": 5, "search_depth": "basic", "chunks_per_source": 2, "open_datasets": ["research/academic"]}},
    "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": "agent-f8bf71ab17ed8eccad8c0e8ae708273f",
    "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"
  }
}

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/api/v3/agents/agent-f8bf71ab17ed8eccad8c0e8ae708273f/versions' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-4o",
    "capabilities": {"web_search": {"open_datasets": ["research/academic"]}},
    "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": {"web_search": {"max_results": 5, "search_depth": "basic", "chunks_per_source": 2, "open_datasets": ["research/academic"]}},
    "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": "agent-f8bf71ab17ed8eccad8c0e8ae708273f",
    "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:modify

Path Parameters

string

required

Agent identifier

Request Body

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

string

Model to use for this version

object

Capabilities of the new version, in the same form as capabilities on Create Agent.

object

Updated execution policies

Show Policies object

integer

Maximum number of conversation turns per run

integer

Maximum number of tool calls per turn

array

Allowlist of tool names the agent may invoke

array

Denylist of tool names the agent must not invoke

integer

Maximum seconds a subagent may run before being cancelled

integer

Maximum number of subagents that may run concurrently

object

Updated output configuration

Show Output object

string

Output mode (text or json)

object

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

array

Updated subagent definitions

Show Subagent object

string

Subagent name

string

Execution mode for the subagent

string

Context instructions passed to the subagent

boolean

Whether the subagent inherits the parent agent’s tools

array

Updated skill references. Every skill must be usable: if any has not passed security review, does not exist, or has no package, the request fails with 400 and SKILL_NOT_USABLE, naming each skill and the reason.

Show Skill reference

string

Skill ID

integer

Pin the reference to this version. Omit to follow the latest version. A pinned reference is checked against that version’s own review result.

string

Updated system prompt

object

Updated model-specific settings

object

Updated runtime binding configuration

curl -X POST 'https://app.memorylake.ai/openapi/memorylake/api/v3/agents/agent-f8bf71ab17ed8eccad8c0e8ae708273f/versions' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-4o",
    "capabilities": {"web_search": {"open_datasets": ["research/academic"]}},
    "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

object

Show Agent version object

integer

Version number of the newly created version

string

Model used in this version

object

Capabilities of this version, keyed by capability name. The platform fills in default values for fields you didn’t set, so a configuration can include fields these docs don’t describe.

object

Execution policies for this version

Show Policies object

integer

Maximum number of conversation turns per run

integer

Maximum number of tool calls per turn

array

Allowlist of tool names the agent may invoke

array

Denylist of tool names the agent must not invoke

integer

Maximum seconds a subagent may run before being cancelled

integer

Maximum number of subagents that may run concurrently

object

Output configuration for this version

Show Output object

string

Output mode

object

JSON Schema for structured output

array

Subagent definitions in this version

Show Subagent object

string

Subagent name

string

Execution mode for the subagent

string

Context instructions passed to the subagent

boolean

Whether the subagent inherits the parent agent’s tools

array

Skills in this version

Show Skill reference

string

Skill identifier

integer

Skill version number

string

Parent agent identifier

string

System prompt used in this version

object

Model-specific settings for this version

object

Runtime binding configuration for this version

string

Version creation timestamp

{
  "success": true,
  "data": {
    "version": 4,
    "model": "gpt-4o",
    "capabilities": {"web_search": {"max_results": 5, "search_depth": "basic", "chunks_per_source": 2, "open_datasets": ["research/academic"]}},
    "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": "agent-f8bf71ab17ed8eccad8c0e8ae708273f",
    "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"
  }
}

MemoryLake API

Memory Router API

Path Parameters

Request Body

Response

​Path Parameters

​Request Body

​Response

Path Parameters

Request Body

Response