curl -X GET "http://localhost:8000/api/v2/agents"
curl -X GET "https://memanto.example.com/api/v2/agents" \
-H "Authorization: Bearer $MOORCHEH_API_KEY"
{
"agents": [
{
"agent_id": "customer-support",
"namespace": "memanto_agent_customer-support",
"pattern": "support",
"description": "Handles customer inquiries",
"created_at": "2026-05-04T10:30:00.000000",
"last_session": "2026-05-04T14:22:00.000000",
"memory_count": 42,
"session_count": 5,
"status": "ready"
},
{
"agent_id": "data-analyst",
"namespace": "memanto_agent_data-analyst",
"pattern": "project",
"description": "Analyzes metrics",
"created_at": "2026-05-03T09:15:00.000000",
"last_session": null,
"memory_count": 0,
"session_count": 0,
"status": "ready"
}
],
"count": 2
}
{
"detail": "Unauthorized. Agent management endpoints require either a loopback client or a valid management credential (Authorization: Bearer <key> or X-Api-Key)."
}
{
"detail": {
"error": "InternalServerError",
"message": "An unexpected error occurred",
"details": {
"original_error": "..."
}
}
}
Agent Management
List Agents
List all agents registered with Memanto.
GET
/
api
/
v2
/
agents
curl -X GET "http://localhost:8000/api/v2/agents"
curl -X GET "https://memanto.example.com/api/v2/agents" \
-H "Authorization: Bearer $MOORCHEH_API_KEY"
{
"agents": [
{
"agent_id": "customer-support",
"namespace": "memanto_agent_customer-support",
"pattern": "support",
"description": "Handles customer inquiries",
"created_at": "2026-05-04T10:30:00.000000",
"last_session": "2026-05-04T14:22:00.000000",
"memory_count": 42,
"session_count": 5,
"status": "ready"
},
{
"agent_id": "data-analyst",
"namespace": "memanto_agent_data-analyst",
"pattern": "project",
"description": "Analyzes metrics",
"created_at": "2026-05-03T09:15:00.000000",
"last_session": null,
"memory_count": 0,
"session_count": 0,
"status": "ready"
}
],
"count": 2
}
{
"detail": "Unauthorized. Agent management endpoints require either a loopback client or a valid management credential (Authorization: Bearer <key> or X-Api-Key)."
}
{
"detail": {
"error": "InternalServerError",
"message": "An unexpected error occurred",
"details": {
"original_error": "..."
}
}
}
Overview
Returns every agent stored locally by Memanto, sorted by creation time (newest first). Each entry includes namespace, pattern, activity counters, and status.Authentication
string
Bearer <key> — required unless the request originates from a loopback client. See Management Endpoint Authentication.string
Alternative to
Authorization: Bearer — same credential.Query Parameters
boolean
default:"true"
Fill
memory_count with live counts from Moorcheh. The counts are cached for 5 minutes, so a new memory may take that long to show up. Pass false for a faster response; memory_count then shows the locally stored value, which can be out of date.curl -X GET "http://localhost:8000/api/v2/agents"
curl -X GET "https://memanto.example.com/api/v2/agents" \
-H "Authorization: Bearer $MOORCHEH_API_KEY"
{
"agents": [
{
"agent_id": "customer-support",
"namespace": "memanto_agent_customer-support",
"pattern": "support",
"description": "Handles customer inquiries",
"created_at": "2026-05-04T10:30:00.000000",
"last_session": "2026-05-04T14:22:00.000000",
"memory_count": 42,
"session_count": 5,
"status": "ready"
},
{
"agent_id": "data-analyst",
"namespace": "memanto_agent_data-analyst",
"pattern": "project",
"description": "Analyzes metrics",
"created_at": "2026-05-03T09:15:00.000000",
"last_session": null,
"memory_count": 0,
"session_count": 0,
"status": "ready"
}
],
"count": 2
}
{
"detail": "Unauthorized. Agent management endpoints require either a loopback client or a valid management credential (Authorization: Bearer <key> or X-Api-Key)."
}
{
"detail": {
"error": "InternalServerError",
"message": "An unexpected error occurred",
"details": {
"original_error": "..."
}
}
}
Next Steps
After listing your agents, you can:- Create Agent to add a new one
- Get Agent to inspect a specific agent
- Activate Agent to begin a session with an agent