Memory Store の作成

Memory Store コンテナを作成します。返された memstore_... ID は Identity と Template にマウントするか、Memory エントリの直接作成に使用できます。

パス

POST /api/v1/forward/memory_stores

ヘッダー

ヘッダー	必須	説明
`Authorization`	はい	`Bearer <PAT or admin SAT>`
`Idempotency-Key`	はい	作成リクエストの冪等性キー。同じキーは同じリクエストボディでのみ再利用できます。省略すると `400` が返されます。
`Content-Type`	はい	`application/json`

リクエストボディ

フィールド	型	必須	説明
`name`	string	はい	空でない表示名。改行 `\n`、復帰 `\r`、タブ `\t` を除く非表示制御文字（`U+0000`～`U+001F`、`U+007F`）は使用できません。
`description`	string	いいえ	自由記述の説明。非表示制御文字は使用できません。
`metadata`	object	いいえ	値が文字列のキー・バリューメタデータ。最大 15 キー、キーは 1～64 文字、値は 512 文字以下です。`created_by` は Forward の予約キーで、サーバーが `"forward"` を設定します。呼び出し元が指定すると `400 invalid_request_error` が返されます。Store メタデータの制約を参照してください。

リクエスト例

curl -X POST "https://api.qoder.com/api/v1/forward/memory_stores" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: create-alpha-store-v1" \
  -d '{
    "name": "project-alpha-memory",
    "description": "Agent knowledge base for project Alpha",
    "metadata": {"team": "backend"}
  }'

レスポンス例

HTTP 200 OK

{
  "id": "memstore_00mc7mukn7lkxr454tjd",
  "type": "memory_store",
  "name": "project-alpha-memory",
  "description": "Agent knowledge base for project Alpha",
  "status": "active",
  "entry_count": 0,
  "total_size": 0,
  "metadata": {
    "team": "backend",
    "created_by": "forward"
  },
  "system_managed": false,
  "identity_id": null,
  "created_at": "2026-08-14T10:00:00Z",
  "updated_at": "2026-08-14T10:00:00Z",
  "archived_at": null,
  "binding_info": {
    "identity_template_count": 0
  }
}

レスポンス

Memory Store オブジェクトを返します。

エラー

HTTP	Type	発生条件
400	`invalid_request_error`	リクエストボディが無効です。`name` がないか制御文字を含む、metadata が 15 キーを超えるか `created_by` を含む、または `Idempotency-Key` がありません。
401	`authentication_error`	認証トークンがないか無効です。
403	`permission_error`	呼び出し元にリソースの作成権限がありません。
409	`conflict_error`	同じ `Idempotency-Key` が異なるリクエストボディで使用されたか、作成処理の復旧に手動対応が必要です。
500/502/503	`api_error`	Forward または依存サービスでエラーが発生しました。

​パス

​ヘッダー

​リクエストボディ

​リクエスト例

​レスポンス例

​レスポンス

​エラー

パス

ヘッダー

リクエストボディ

リクエスト例

レスポンス例

レスポンス

エラー