curl -X GET "http://localhost:8000/api/v2/agents/customer-support"
{
"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"
}
{
"detail": "Unauthorized. Agent management endpoints require either a loopback client or a valid management credential (Authorization: Bearer <key> or X-Api-Key)."
}
{
"detail": {
"error": "AgentNotFound",
"message": "Agent 'customer-support' not found",
"details": {}
}
}
{
"detail": {
"error": "InternalServerError",
"message": "An unexpected error occurred",
"details": {
"original_error": "..."
}
}
}
Agent Management
Get Agent
Get detailed information about a specific agent.
GET
/
api
/
v2
/
agents
/
{agent_id}
curl -X GET "http://localhost:8000/api/v2/agents/customer-support"
{
"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"
}
{
"detail": "Unauthorized. Agent management endpoints require either a loopback client or a valid management credential (Authorization: Bearer <key> or X-Api-Key)."
}
{
"detail": {
"error": "AgentNotFound",
"message": "Agent 'customer-support' not found",
"details": {}
}
}
{
"detail": {
"error": "InternalServerError",
"message": "An unexpected error occurred",
"details": {
"original_error": "..."
}
}
}
Overview
Returns metadata and counters for one agent registered with Memanto (namespace, pattern, sessions, etc.).Authentication
string
Bearer <key> — required unless the request originates from a loopback client. See Management Endpoint Authentication.string
Alternative to
Authorization: Bearer — same credential.Path Parameters
string
required
The unique identifier of the agent.
Query Parameters
boolean
default:"true"
Fill
memory_count with a live count from this agent’s Moorcheh namespace. Pass false to skip the lookup; memory_count then shows the locally stored value, which can be out of date.curl -X GET "http://localhost:8000/api/v2/agents/customer-support"
{
"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"
}
{
"detail": "Unauthorized. Agent management endpoints require either a loopback client or a valid management credential (Authorization: Bearer <key> or X-Api-Key)."
}
{
"detail": {
"error": "AgentNotFound",
"message": "Agent 'customer-support' not found",
"details": {}
}
}
{
"detail": {
"error": "InternalServerError",
"message": "An unexpected error occurred",
"details": {
"original_error": "..."
}
}
}
Next Steps
Once you have verified the agent’s details, you can:- Activate Agent to start a session
- List all Agents
- Delete Agent if it’s no longer needed