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
string
required
Agent identifier. Interpreted as the internal ID by default, or as the custom ID when
by_custom_id is true.Query Parameters
boolean
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
object
Show Agent object
Show Agent object
string
Unique agent identifier
string
Agent name
string
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
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
array
array
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",
"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"
}
}