GET /openapi/memorylake/api/v3/agents/{id}
id path parameter is matched against the internal agent ID. Set by_custom_id=true to look up the agent by its custom identifier instead.
Permission required:
agent:readPath Parameters
Agent identifier. Interpreted as the internal ID by default, or as the custom ID when
by_custom_id is true.Query Parameters
When
true, the id path parameter is matched against the agent’s custom_id instead of its internal id.curl -X GET 'https://app.memorylake.ai/openapi/memorylake/api/v3/agents/agt_r8k2m1n3' \
-H 'Authorization: Bearer sk_xxxxxx'
Response
Show Agent object
Show Agent object
Unique agent identifier
Agent name
Agent description
Arbitrary key-value pairs for storing additional agent information
Current active version number
Model used by the agent
List of capability identifiers the agent supports
Execution policies that constrain agent behavior
Show Policies object
Show Policies object
Maximum number of conversation turns per run
Maximum number of tool calls per turn
Allowlist of tool names the agent may invoke
Denylist of tool names the agent must not invoke
Maximum seconds a subagent may run before being cancelled
Maximum number of subagents that may run concurrently
Custom identifier for external system integration
Actor identifier associated with this agent
Latest version number available for this agent
System prompt used to instruct the agent
Model-specific settings such as temperature and max tokens
Runtime binding configuration for tools and data sources
Creation timestamp
Last update timestamp
{
"success": true,
"data": {
"id": "agt_r8k2m1n3",
"name": "Support Assistant",
"description": "Handles customer support inquiries using knowledge base",
"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-04-22T14:30:00Z"
}
}