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

# Memory Store を作成する

> 新しい Memory Store を作成します。

`POST /api/v1/cloud/memory_stores`

新しい Memory Store を作成します。

## ヘッダー

| ヘッダー            | 必須 | 説明                 |
| --------------- | -- | ------------------ |
| `Authorization` | はい | `Bearer <PAT>`     |
| `Content-Type`  | はい | `application/json` |

## リクエストボディ

| フィールド         | 型      | 必須  | 説明                                                     |
| ------------- | ------ | --- | ------------------------------------------------------ |
| `name`        | string | はい  | 人間が読める名前。1〜255 文字、制御文字は不可                              |
| `description` | string | いいえ | 自由記述の説明。最大 1024 文字。ストアがアタッチされると Agent のシステムプロンプトに含まれます |
| `metadata`    | object | いいえ | キーバリュータグ。最大 16 個のペア。キーは 1〜64 文字、値は最大 512 文字            |

## リクエスト例

```bash theme={null}
curl -X POST "https://api.qoder.com/api/v1/cloud/memory_stores" \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "project-alpha-memory",
    "description": "Agent knowledge base for project Alpha",
    "metadata": {"team": "backend"}
  }'
```

## レスポンス

[Memory Store オブジェクト](#memory-store-object)を返します。

```json theme={null}
{
  "id": "memstore_019e5cdb9c3f71c3b6505eba937a40b4",
  "created_at": "2026-05-18T08:00:00.000Z",
  "name": "project-alpha-memory",
  "type": "memory_store",
  "updated_at": "2026-05-18T08:00:00.000Z",
  "archived_at": null,
  "description": "Agent knowledge base for project Alpha",
  "metadata": {"team": "backend"},
  "status": "active",
  "entry_count": 0,
  "total_size": 0
}
```