Memory Store の更新

Memory Store の name、description、metadata を更新します。この API は部分更新として動作し、省略したフィールドは変更されず、null は拒否されます。

パス

POST /api/v1/forward/memory_stores/{memory_store_id}

ヘッダー

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

パスパラメータ

パラメータ	型	必須	説明
`memory_store_id`	string	はい	Memory Store ID（`memstore_...`）。

リクエストボディ

フィールド	型	必須	説明
`name`	string	いいえ	新しい名前。指定する場合は空にできず、非表示制御文字を含められません。
`description`	string	いいえ	新しい説明。指定する場合は非表示制御文字を含められません。
`metadata`	object	いいえ	新しいメタデータ。現在のメタデータとマージせず、全体を置き換えます。Store メタデータの制約を参照してください。

リクエストボディには上記のフィールドを少なくとも 1 つ含める必要があります。

リクエスト例

curl -X POST "https://api.qoder.com/api/v1/forward/memory_stores/memstore_00mc7mukn7lkxr454tjd" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Project Alpha v2 knowledge base"
  }'

レスポンス例

HTTP 200 OK

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

レスポンス

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

エラー

HTTP	Type	発生条件
400	`invalid_request_error`	リクエストボディが無効です。フィールドが指定されていない、`name` が空か制御文字を含む、または metadata が制約に違反しています。
401	`authentication_error`	認証トークンがないか無効です。
403	`permission_error`	呼び出し元にこのリソースへのアクセス権限がありません。
404	`not_found_error`	Store が存在しないか、別ユーザーのため参照できません。
409	`conflict_error`	Store はアーカイブ済みのため変更できません。
500/502/503	`api_error`	Forward または依存サービスでエラーが発生しました。

​パス

​ヘッダー

​パスパラメータ

​リクエストボディ

​リクエスト例

​レスポンス例

​レスポンス

​エラー