v21

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

Create Agent

Create a new MEMANTO agent

Creates:

  • Agent metadata in ~/.memanto/agents/
  • Moorcheh namespace: memanto_agent_{agent_id}

The agent is ready to activate once created.

post/api/v2/agents

Headers

authorizationstring nullable
X-Api-Keystring nullable

Request body

agent_idstring required

Unique agent identifier (alphanumeric, hyphens, underscores)

pattern'support' | 'project' | 'tool'

Agent pattern types for memory organization

descriptionstring nullable

Human-readable description of the agent

Response

Successful Response

agent_idstring required
namespacestring required
pattern'support' | 'project' | 'tool' required

Agent pattern types for memory organization

descriptionstring nullable
created_atstring date-time required
last_sessionstring date-time nullable
memory_countinteger
session_countinteger
statusstring