> ## Documentation Index
> Fetch the complete documentation index at: https://docs.memanto.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Agent

> Create an agent: a separate memory namespace your tools share.

## Overview

Creates an agent. Only an account **admin** can create agents; a key belonging to an invited member gets `403`. How many agents you can have depends on your plan.

## Authentication

**x-api-key** `string` *required*

Your Memanto Cloud API key (`mk_...`). See [Authentication](https://docs.memanto.ai/cloud/api/introduction.md#authentication).

## Body

**agent\_id** `string` *required*

Letters, digits, `-` and `_` only.

**pattern** `string` (default: support)

`support`, `project` or `tool`.

**description** `string`

Optional description.

Returns `409` if an agent with this ID already exists.

```bash cURL theme={null}
curl -X POST "https://api.memanto.ai/agents" \
  -H "x-api-key: $MEMANTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "my-agent",
    "pattern": "tool",
    "description": "Coding assistant memory"
  }'
```

```json 200 - OK theme={null}
{
  "agent_id": "my-agent",
  "pattern": "tool",
  "description": "Coding assistant memory",
  "created_at": "2026-11-19T15:04:05.000Z",
  "status": "ready"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.