Skip to main content
GET
/
api
/
v2
/
agents
curl -X GET "http://localhost:8000/api/v2/agents"

{
  "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
}

​
Overview

Returns every agent stored locally by Memanto, sorted by creation time (newest first). Each entry includes namespace, pattern, activity counters, and status.

​
Authentication

API clients do not send an API key or Authorization header. 
curl -X GET "http://localhost:8000/api/v2/agents"

{
  "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
}

​
Next Steps

After listing your agents, you can: