Update Agent - MemoryLake AI

curl -X PATCH 'https://app.memorylake.ai/openapi/memorylake/api/v3/agents/agt_r8k2m1n3' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Support Assistant (Production)",
    "description": "Production support agent with knowledge base integration"
  }'

{
  "success": true,
  "data": {
    "id": "agt_r8k2m1n3",
    "name": "Support Assistant (Production)",
    "description": "Production support agent with knowledge base integration",
    "metadata": {
      "team": "customer-success",
      "tier": "production"
    },
    "version": 3,
    "model": "gpt-4o",
    "capabilities": ["tool_use", "memory_read", "memory_write"],
    "policies": {
      "max_turns": 20,
      "max_tool_calls": 10,
      "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": 2
      }
    ],
    "custom_id": "support-assistant-v1",
    "actor_id": "act_p4q7w2x9",
    "latest_version": 3,
    "system_prompt": "You are a helpful support assistant. Use the knowledge base to answer questions accurately.",
    "model_settings": {
      "temperature": 0.7,
      "max_tokens": 4096
    },
    "runtime_bindings": {
      "knowledge_base": "kb_prod_docs"
    },
    "created_at": "2025-03-10T09:00:00Z",
    "updated_at": "2025-05-01T11:45:00Z"
  }
}

PATCH /openapi/memorylake/api/v3/agents/{id}

Updates an existing agent’s identity fields. Only the fields you include in the request body are modified; omitted fields remain unchanged. This endpoint updates identity fields only (name, description, metadata). To change the agent’s model, capabilities, policies, or other configuration, create a new version with the Create Agent Version endpoint.

Permission required: agent:modify

Path Parameters

string

required

Agent identifier

Request Body

string

Updated agent name

string

Updated agent description

object

Updated key-value pairs. Replaces the existing metadata entirely.

curl -X PATCH 'https://app.memorylake.ai/openapi/memorylake/api/v3/agents/agt_r8k2m1n3' \
  -H 'Authorization: Bearer sk_xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Support Assistant (Production)",
    "description": "Production support agent with knowledge base integration"
  }'

Response

object

Show Agent object

string

Unique agent identifier

string

Updated agent name

string

Updated agent description

object

Arbitrary key-value pairs for storing additional agent information

integer

Current active version number

string

Model used by the agent

array

List of capability identifiers the agent supports

object

Execution policies that constrain agent behavior

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 the agent

Show Output object

string

Output mode

object

JSON Schema for structured output

array

Subagent definitions attached to this agent

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 attached to this agent

Show Skill reference

string

Skill identifier

integer

Skill version number

string

Custom identifier for external system integration

string

Actor identifier associated with this agent

integer

Latest version number available for this agent

string

System prompt used to instruct the agent

object

Model-specific settings such as temperature and max tokens

object

Runtime binding configuration for tools and data sources

string

Creation timestamp

string

Last update timestamp

{
  "success": true,
  "data": {
    "id": "agt_r8k2m1n3",
    "name": "Support Assistant (Production)",
    "description": "Production support agent with knowledge base integration",
    "metadata": {
      "team": "customer-success",
      "tier": "production"
    },
    "version": 3,
    "model": "gpt-4o",
    "capabilities": ["tool_use", "memory_read", "memory_write"],
    "policies": {
      "max_turns": 20,
      "max_tool_calls": 10,
      "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": 2
      }
    ],
    "custom_id": "support-assistant-v1",
    "actor_id": "act_p4q7w2x9",
    "latest_version": 3,
    "system_prompt": "You are a helpful support assistant. Use the knowledge base to answer questions accurately.",
    "model_settings": {
      "temperature": 0.7,
      "max_tokens": 4096
    },
    "runtime_bindings": {
      "knowledge_base": "kb_prod_docs"
    },
    "created_at": "2025-03-10T09:00:00Z",
    "updated_at": "2025-05-01T11:45:00Z"
  }
}

​Path Parameters

​Request Body

​Response

Path Parameters

Request Body

Response