Memory の更新

Memory の内容またはメタデータを更新します。更新のたびに operation=updated のバージョンスナップショットが自動生成されます。 楽観的同時実行制御を行うには content_sha256 を指定します。サーバー上の現在のハッシュと一致しない場合は同時書き込みが発生したものとして 409 が返されます。省略すると検証を行いません。

パス

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

ヘッダー

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

パスパラメータ

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

リクエストボディ

フィールド	型	必須	説明
`content`	string	はい	新しい UTF-8 プレーンテキスト。元の内容は 100 KiB 以下です。content の制約を参照してください。
`content_sha256`	string	いいえ	楽観的同時実行制御に使用する現在の内容の想定 SHA-256。不一致の場合は `409` が返されます。
`metadata`	object	いいえ	新しいメタデータ。マージせず現在のメタデータを全体置換します。省略すると現在の値を保持します。Memory メタデータの制約を参照してください。

path は更新できません。変更するには元の Memory を削除して新しい Memory を作成します。

リクエスト例

curl -X POST "https://api.qoder.com/api/v1/forward/memory_stores/memstore_00mc7mukn7lkxr454tjd/memories/mem_00mc7mvag5u68kkfvxhy" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "# Architecture decision v2\n\nUse a modular monolith.",
    "content_sha256": "1712de0d497a5aeef2beeccf4fbb7d5a16944975438d0c25447b9c1fba13099a"
  }'

レスポンス例

HTTP 200 OK

{
  "id": "mem_00mc7mvag5u68kkfvxhy",
  "type": "memory",
  "memory_store_id": "memstore_00mc7mukn7lkxr454tjd",
  "path": "decisions/arch-choice.md",
  "content": "# Architecture decision v2\n\nUse a modular monolith.",
  "content_size_bytes": 108,
  "content_sha256": "9a4f8d2c1b7e6543210fedcba9876543210fedcba9876543210fedcba987654",
  "metadata": {"owner": "backend-team"},
  "created_at": "2026-08-14T10:00:00Z",
  "updated_at": "2026-08-14T11:00:00Z"
}

レスポンス

content を含む、更新後の Memory オブジェクトを返します。

注意事項

アーカイブ済みの Memory Store にある Memory は更新できず、409 が返されます。

エラー

HTTP	Type	発生条件
400	`invalid_request_error`	`content` がないか無効、100 KiB を超える、非表示制御文字を含む、または metadata が制約に違反しています。
401	`authentication_error`	認証トークンがないか無効です。
403	`permission_error`	呼び出し元にこのリソースへのアクセス権限がありません。
404	`not_found_error`	Memory Store または Memory が存在しないか、別ユーザーのため参照できません。
409	`conflict_error`	同時書き込みにより `content_sha256` が現在の内容と一致しないか、Store がアーカイブ済みです。
500/502/503	`api_error`	Forward または依存サービスでエラーが発生しました。

​パス

​ヘッダー

​パスパラメータ

​リクエストボディ

​リクエスト例

​レスポンス例

​レスポンス

​注意事項

​エラー

パス