Skip to main content
POST

Overview

Create a new agent namespace for storing and retrieving memories. Each agent receives a unique agent_id which acts as an isolated context container in Moorcheh (memanto_agent_{agent_id}).

Authentication

Memanto validates Moorcheh credentials on the server using MOORCHEH_API_KEY (environment / server configuration).
string
Bearer <key> — required unless the request originates from a loopback client. See Management Endpoint Authentication.
string
Alternative to Authorization: Bearer — same credential.
string
required
Must be application/json

Body

string
required
Unique agent identifier (alphanumeric, hyphens, underscores only).
string
Agent pattern for memory organization. One of: support, project, tool. Defaults to support.
string
Optional human-readable description of the agent.
Common causes of 500 include the server missing MOORCHEH_API_KEY, an invalid key (Memanto may fail at startup), or failure to create the namespace in Moorcheh.

Next Steps

After creating a new agent, you can: