メインコンテンツへスキップ
POST /v1/memory_stores Memory Store を作成し、Memory Store オブジェクトを返します。

​
ヘッダー

ヘッダー値必須
AuthorizationBearer $QODER_PATはい
Content-Typeapplication/jsonはい

​
リクエストボディ

フィールド型必須説明
namestringはいストア名。サーバーが前後の空白を除去。最大 64 文字
descriptionstringはいストアの説明。サーバーが前後の空白を除去。最大 1024 文字
metadataメタデータオブジェクトいいえカスタムメタデータ。デフォルトは {}

​
リクエスト例

curl -X POST "https://api.qoder.com/api/v1/cloud/memory_stores" \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-store",
    "description": "プロジェクトメモストレージ",
    "metadata": {
      "project": "qoder-docs"
    }
  }'

​
レスポンス例

HTTP 201 Created 
{
  "id": "memstore_019e3bb8d50674d9b082b73709c29c87",
  "type": "memory_store",
  "name": "my-store",
  "description": "プロジェクトメモストレージ",
  "status": "active",
  "entry_count": 0,
  "total_size": 0,
  "metadata": {
    "project": "qoder-docs"
  },
  "created_at": "2026-05-18T15:33:49.449264Z",
  "updated_at": "2026-05-18T15:33:49.449264Z"
}

​
レスポンスフィールド

フィールド型説明
idstringMemory Store ID、memstore_ プレフィックス
typestring固定値 "memory_store"
namestringストア名
descriptionstringストアの説明
statusstringストアの状態。Memory Store のステータスを参照
entry_countintegerアクティブなメモリエントリ数
total_sizeintegerアクティブなメモリエントリの総サイズ（バイト）
metadataメタデータオブジェクトカスタムメタデータ
archived_atstringストアがアーカイブされている場合のみ返される
created_atstringUTC 作成時刻
updated_atstringUTC 最終更新時刻

​
注意事項

  • 同名 Memory Store の作成が許可されます
  • 新規作成 Store の初期状態は active です
  • entry_count と total_size の初期値は 0 です

​
エラーレスポンス

HTTPtype説明
400invalid_request_errorname、description、または metadata が欠落または不正
401authentication_error認証トークンが提供されていないまたは無効

​
関連項目

Memory Stores

Agent に Session をまたいだ永続メモリを与える。