Sign in

v21

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-044334120.9 KB
Sessions & Agents

Activate Agent

Activate agent and start session

Creates:

  • JWT session token (6-hour expiration by default, configurable)
  • Session file in ~/.memanto/sessions/
  • Active session marker

Returns session token for use in memory operations.

post/api/v2/agents/{agent_id}/activate

Path parameters

agent_idstring required

Headers

authorizationstring nullable
X-Api-Keystring nullable

Response

Successful Response

session_idstring required
session_tokenstring required
agent_idstring required
namespacestring required
started_atstring date-time required
expires_atstring date-time required
pattern'support' | 'project' | 'tool'

Agent pattern types for memory organization

status'active' | 'expired' | 'terminated'

Session status enum

metadataobject nullable