Memory の作成

Memory Store に Memory エントリを作成します。active な path は Store 内で一意である必要があり、重複する path を作成すると 409 が返されます。 Memory を作成すると、operation=created のバージョンスナップショットが自動生成されます。

パス

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

ヘッダー

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

パスパラメータ

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

リクエストボディ

フィールド	型	必須	説明
`path`	string	はい	Store 内の大文字と小文字を区別する相対パス。path の制約を参照してください。
`content`	string	はい	base64 ではない UTF-8 プレーンテキスト。元の内容は 100 KiB 以下です。content の制約を参照してください。
`metadata`	object	いいえ	値が文字列のキー・バリューメタデータ。最大 16 キー。Memory メタデータの制約を参照してください。

リクエスト例

curl -X POST "https://api.qoder.com/api/v1/forward/memory_stores/memstore_00mc7mukn7lkxr454tjd/memories" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "path": "decisions/arch-choice.md",
    "content": "# Architecture decision\n\nUse a microservices architecture.",
    "metadata": {"owner": "backend-team"}
  }'

レスポンス例

HTTP 200 OK

{
  "id": "mem_00mc7mvag5u68kkfvxhy",
  "type": "memory",
  "memory_store_id": "memstore_00mc7mukn7lkxr454tjd",
  "path": "decisions/arch-choice.md",
  "content": "# Architecture decision\n\nUse a microservices architecture.",
  "content_size_bytes": 99,
  "content_sha256": "1712de0d497a5aeef2beeccf4fbb7d5a16944975438d0c25447b9c1fba13099a",
  "metadata": {"owner": "backend-team"},
  "created_at": "2026-08-14T10:00:00Z",
  "updated_at": "2026-08-14T10:00:00Z"
}

レスポンス

content を含む Memory オブジェクトを返します。

注意事項

アーカイブ済みの Memory Store には Memory を作成できず、409 が返されます。

エラー

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

​パス

​ヘッダー

​パスパラメータ

​リクエストボディ

​リクエスト例

​レスポンス例

​レスポンス

​注意事項

​エラー

パス