メインコンテンツへスキップ
GET /v1/memory_stores/{memory_store_id}/versions 指定された Memory Store 内のメモリエントリのバージョン履歴を取得します。一覧レスポンスには content は含まれません。

​
パスパラメータ

パラメータ型必須説明
memory_store_idstringはいMemory Store ID（memstore_ プレフィックス）

​
ヘッダー

ヘッダー値必須
AuthorizationBearer $QODER_PATはい

​
クエリパラメータ

パラメータ型必須説明
limitintegerいいえ1 ページあたりの返却件数上限。正の整数。デフォルト 20、最大 100
after_idstringいいえカーソルページネーション：この ID 以降のレコードを返す。before_id と排他
before_idstringいいえカーソルページネーション：この ID 以前のレコードを返す。after_id と排他
entry_idstringいいえ指定したメモリエントリ ID のバージョンのみ返す
created_at[gte]stringいいえこの RFC 3339 タイムスタンプ以降に作成されたレコードを返す
created_at[lte]stringいいえこの RFC 3339 タイムスタンプ以前に作成されたレコードを返す

​
リクエスト例

curl -X GET "https://api.qoder.com/api/v1/cloud/memory_stores/memstore_xxx/versions" \
  -H "Authorization: Bearer $QODER_PAT"

# ページネーション
curl -X GET "https://api.qoder.com/api/v1/cloud/memory_stores/memstore_xxx/versions?limit=2&after_id=memver_xxx" \
  -H "Authorization: Bearer $QODER_PAT"

# 特定エントリでフィルタ
curl -X GET "https://api.qoder.com/api/v1/cloud/memory_stores/memstore_xxx/versions?entry_id=mem_xxx" \
  -H "Authorization: Bearer $QODER_PAT"

​
レスポンス例

HTTP 200 OK 
{
  "data": [
    {
      "id": "memver_019e3bb9e5197b0c816e621050a8394e",
      "type": "memory_version",
      "store_id": "memstore_019e3bb93b7074f9a5130d39ddcca90f",
      "entry_id": "mem_019e3bb9cf417d7dbb11fe9784dbb65c",
      "entry_path": "versions/test.md",
      "action": "updated",
      "size": 27,
      "content_sha256": "ff1328301132f954eeac24cd379ab7f6f5a540573bfe3eb2db3995abe3678210",
      "redacted": false,
      "created_at": "2026-05-18T15:34:59.125612Z"
    },
    {
      "id": "memver_019e3bb9cf417d89970ba7f45e728c56",
      "type": "memory_version",
      "store_id": "memstore_019e3bb93b7074f9a5130d39ddcca90f",
      "entry_id": "mem_019e3bb9cf417d7dbb11fe9784dbb65c",
      "entry_path": "versions/test.md",
      "action": "created",
      "size": 17,
      "content_sha256": "fe80a065cb120813abf7dfceb4018a53d6eb7140c785181634e019656176c64e",
      "redacted": false,
      "created_at": "2026-05-18T15:34:53.528628Z"
    }
  ],
  "first_id": "memver_019e3bb9e5197b0c816e621050a8394e",
  "last_id": "memver_019e3bb9cf417d89970ba7f45e728c56",
  "has_more": false
}

​
レスポンスフィールド

フィールド型説明
dataarrayメモリバージョンオブジェクトの配列。content は省略される
first_idstring | null現在ページ先頭レコード ID。data が空の場合は null
last_idstring | null現在ページ末尾レコード ID。data が空の場合は null
has_morebooleanさらにレコードがあるかどうか

​
ページネーション

メモリバージョン一覧はリソース ID の降順で返されます。has_more が true の場合、after_id=<last_id> で次のページを取得します。

​
エラーレスポンス

HTTPtype説明
400invalid_request_error無効な limit、無効なタイムスタンプ、または before_id と after_id の両方が指定されている
401authentication_error認証トークンが提供されていないまたは無効
404not_found_error指定の Memory Store が存在しない

​
関連項目

Memory Stores

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