Permission required:
agent:modifyPath Parameters
Agent identifier
Request Body
Updated agent name
Updated agent description
Updated key-value pairs. Replaces the existing metadata entirely.
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
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"
}
}
Update an agent’s identity fields such as name, description, and metadata
PATCH /openapi/memorylake/api/v3/agents/{id}
agent:modifycurl -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"
}'
Show Agent object
Show Policies object
{
"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"
}
}