Memory バージョンの一覧取得

Memory Store 内のバージョンスナップショットを一覧取得します。バージョンは Store 単位で管理され、memory_id で 1 つの Memory の履歴に絞り込めます。 Memory の作成、更新、削除のたびに変更不可のバージョンが自動生成されます。一覧レスポンスには content は含まれません。バージョン内容を取得するには Memory バージョンの取得を使用します。

パス

GET /api/v1/forward/memory_stores/{memory_store_id}/memory_versions

ヘッダー

ヘッダー	必須	説明
`Authorization`	はい	`Bearer <PAT or admin SAT>`

パスパラメータ

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

クエリパラメータ

パラメータ	型	必須	説明
`limit`	integer	いいえ	1 ページあたりの最大件数。1～100、デフォルトは 20。
`before_id`	string	いいえ	前方向ページングのカーソル。`after_id` と同時に指定できません。
`after_id`	string	いいえ	後方向ページングのカーソル。`before_id` と同時に指定できません。
`memory_id`	string	いいえ	この Memory（`mem_...`）のバージョンのみを返します。

リクエスト例

# All versions in a Store
curl -X GET "https://api.qoder.com/api/v1/forward/memory_stores/memstore_00mc7mukn7lkxr454tjd/memory_versions" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

# Version history of one Memory
curl -X GET "https://api.qoder.com/api/v1/forward/memory_stores/memstore_00mc7mukn7lkxr454tjd/memory_versions?memory_id=mem_00mc7mvag5u68kkfvxhy" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

レスポンス例

HTTP 200 OK

{
  "data": [
    {
      "id": "memver_00mc7mw0t337kbcx5q52",
      "type": "memory_version",
      "memory_store_id": "memstore_00mc7mukn7lkxr454tjd",
      "memory_id": "mem_00mc7mvag5u68kkfvxhy",
      "path": "decisions/arch-choice.md",
      "content_size_bytes": 108,
      "content_sha256": "9a4f8d2c1b7e6543210fedcba9876543210fedcba9876543210fedcba987654",
      "operation": "updated",
      "redacted": false,
      "redacted_at": null,
      "created_at": "2026-08-14T11:00:00Z"
    },
    {
      "id": "memver_00mc7mvag5u68lh2y8gwh",
      "type": "memory_version",
      "memory_store_id": "memstore_00mc7mukn7lkxr454tjd",
      "memory_id": "mem_00mc7mvag5u68kkfvxhy",
      "path": "decisions/arch-choice.md",
      "content_size_bytes": 99,
      "content_sha256": "1712de0d497a5aeef2beeccf4fbb7d5a16944975438d0c25447b9c1fba13099a",
      "operation": "created",
      "redacted": false,
      "redacted_at": null,
      "created_at": "2026-08-14T10:00:00Z"
    }
  ],
  "first_id": "memver_00mc7mw0t337kbcx5q52",
  "last_id": "memver_00mc7mvag5u68lh2y8gwh",
  "has_more": false
}

空リストのレスポンス

{
  "data": [],
  "first_id": null,
  "last_id": null,
  "has_more": false
}

レスポンスフィールド

フィールド	型	説明
`data`	array	`content` を含まない Memory Version オブジェクトの配列。
`first_id`	string/null	現在のページの先頭レコード ID。
`last_id`	string/null	現在のページの末尾レコード ID。
`has_more`	boolean	さらにレコードがあるかどうか。

エラー

HTTP	Type	発生条件
400	`invalid_request_error`	`limit` が範囲外、または `after_id` と `before_id` が同時に指定されています。
401	`authentication_error`	認証トークンがないか無効です。
403	`permission_error`	呼び出し元にこのリソースへのアクセス権限がありません。
404	`not_found_error`	Memory Store が存在しないか、別ユーザーのため参照できません。
500/502/503	`api_error`	Forward または依存サービスでエラーが発生しました。

​パス

​ヘッダー

​パスパラメータ

​クエリパラメータ

​リクエスト例

​レスポンス例

​空リストのレスポンス

​レスポンスフィールド

​エラー

パス