GET /openapi/memorylake/api/v3/agents
name_fuzzy and control pagination with page_size and continuation_token.
Permission required:
agent:listQuery Parameters
integer
Number of agents to return per page
string
Token from a previous response to fetch the next page of results
string
Fuzzy match on agent name
curl -X GET 'https://app.memorylake.ai/openapi/memorylake/api/v3/agents?page_size=20' \
-H 'Authorization: Bearer sk_xxxxxx'
Response
object
Show Paginated agent list
Show Paginated agent list
array
Array of agent objects
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 (e.g.
gpt-4o, claude-sonnet-4-20250514)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
string
Token to retrieve the next page of results. Absent when there are no more pages.
{
"success": true,
"data": {
"items": [
{
"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...",
"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"
}
],
"continuation_token": "eyJsYXN0SWQiOiJhZ3RfcjhrMm0xbjMifQ"
}
}