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

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
}
{
  "detail": {
    "error": "InternalServerError",
    "message": "An unexpected error occurred",
    "details": {
      "original_error": "..."
    }
  }
}

Next Steps

After listing your agents, you can: