> ## Documentation Index
> Fetch the complete documentation index at: https://docs.memorylake.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# List Agents
> Returns a paginated list of agents with optional filtering by custom ID
```
GET /openapi/memorylake/api/v3/agents
```
Returns a paginated list of all agents in your account. You can filter by `custom_id` and control pagination with `page_size` and `continuation_token`.
**Permission required:** `agent:list`
### Query Parameters
Number of agents to return per page
Token from a previous response to fetch the next page of results
Filter agents by custom identifier (exact match)
```bash cURL theme={null}
curl -X GET 'https://app.memorylake.ai/openapi/memorylake/api/v3/agents?page_size=20' \
-H 'Authorization: Bearer sk_xxxxxx'
```
### Response
Array of agent objects
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 (e.g. `gpt-4o`, `claude-sonnet-4-20250514`)
List of capability identifiers the agent supports
Execution policies that constrain agent behavior
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
Output configuration for the agent
Output mode (e.g. `text`, `json`)
JSON Schema that the agent's output must conform to when mode is `json`
Subagent definitions attached to this agent
Subagent name
Execution mode for the subagent
Context instructions passed to the subagent
Whether the subagent inherits the parent agent's tools
Skills attached to this agent
Skill identifier
Skill version number
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
Token to retrieve the next page of results. Absent when there are no more pages.
```json Success (200) theme={null}
{
"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"
}
}
```