curl -X GET "http://localhost:8000/api/v2/status"
{
"session_id": "9f733fdb-ebf2-494e-8eb6-fb3320d6020d",
"agent_id": "my-agent",
"namespace": "memanto_agent_my-agent",
"started_at": "2026-05-09T02:40:00.313078Z",
"expires_at": "2026-05-09T08:40:00.313078Z",
"status": "active",
"time_remaining_seconds": 21573,
"pattern": "support"
}
{
"detail": "Unauthorized. Agent management endpoints require either a loopback client or a valid management credential (Authorization: Bearer <key> or X-Api-Key)."
}
{
"detail": "No active session"
}
{
"detail": {
"error": "InternalServerError",
"message": "An unexpected error occurred",
"details": {
"original_error": "..."
}
}
}
Session Management
Get Current Session
Inspect the currently active session, including duration, expiration, and remaining time.
GET
/
api
/
v2
/
status
curl -X GET "http://localhost:8000/api/v2/status"
{
"session_id": "9f733fdb-ebf2-494e-8eb6-fb3320d6020d",
"agent_id": "my-agent",
"namespace": "memanto_agent_my-agent",
"started_at": "2026-05-09T02:40:00.313078Z",
"expires_at": "2026-05-09T08:40:00.313078Z",
"status": "active",
"time_remaining_seconds": 21573,
"pattern": "support"
}
{
"detail": "Unauthorized. Agent management endpoints require either a loopback client or a valid management credential (Authorization: Bearer <key> or X-Api-Key)."
}
{
"detail": "No active session"
}
{
"detail": {
"error": "InternalServerError",
"message": "An unexpected error occurred",
"details": {
"original_error": "..."
}
}
}
Overview
Returns metadata for the session currently marked active in Memanto’s local state — useful to verify session validity before executing memory operations. The endpoint reads the active session marker on the server; no parameters are required.Authentication
No session token — Memanto resolves the active session from local server state.string
Bearer <key> — required unless the request originates from a loopback client. See Management Endpoint Authentication.string
Alternative to
Authorization: Bearer — same credential.curl -X GET "http://localhost:8000/api/v2/status"
{
"session_id": "9f733fdb-ebf2-494e-8eb6-fb3320d6020d",
"agent_id": "my-agent",
"namespace": "memanto_agent_my-agent",
"started_at": "2026-05-09T02:40:00.313078Z",
"expires_at": "2026-05-09T08:40:00.313078Z",
"status": "active",
"time_remaining_seconds": 21573,
"pattern": "support"
}
{
"detail": "Unauthorized. Agent management endpoints require either a loopback client or a valid management credential (Authorization: Bearer <key> or X-Api-Key)."
}
{
"detail": "No active session"
}
{
"detail": {
"error": "InternalServerError",
"message": "An unexpected error occurred",
"details": {
"original_error": "..."
}
}
}
Next Steps
- Activate Agent if no session is active
- Deactivate Agent to end the session early