---
title: "Create Agent"
method: POST
path: "/api/v2/agents"
tags: ["Sessions & Agents"]
---

# Create Agent

`POST /api/v2/agents`

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.

## Headers

- `authorization` string, nullable
- `X-Api-Key` string, nullable

## Request body

- AgentCreate — Request to create a new agent
  - `agent_id` string, required — Unique agent identifier (alphanumeric, hyphens, underscores)
  - `pattern` 'support' | 'project' | 'tool' — Agent pattern types for memory organization
  - `description` string, nullable — Human-readable description of the agent

## Response `201`

Successful Response

- AgentInfo — Agent information
  - `agent_id` string, required
  - `namespace` string, required
  - `pattern` 'support' | 'project' | 'tool', required — Agent pattern types for memory organization
  - `description` string, nullable
  - `created_at` string, date-time, required
  - `last_session` string, date-time, nullable
  - `memory_count` integer
  - `session_count` integer
  - `status` string

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/moorcheh-ai/apis/memanto-memory-that-ai-agents-love.md) · [All operations](https://skmtc.net/moorcheh-ai/apis/memanto-memory-that-ai-agents-love/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/moorcheh-ai/memanto-memory-that-ai-agents-love/revisions/ff157f2fc5d5/schema)