メインコンテンツへスキップ
GET /v1/memory_stores/{memory_store_id}/memories 指定された 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 と排他
path_prefixstringいいえpath がこのプレフィックスで始まるエントリのみ返す
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/memories" \
  -H "Authorization: Bearer $QODER_PAT"

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

# パスプレフィックスでフィルタ
curl -X GET "https://api.qoder.com/api/v1/cloud/memory_stores/memstore_xxx/memories?path_prefix=notes/" \
  -H "Authorization: Bearer $QODER_PAT"

​
レスポンス例

HTTP 200 OK 
{
  "data": [
    {
      "id": "mem_019e3bb965a671fca51bde1cf8d87de0",
      "type": "memory",
      "store_id": "memstore_019e3bb93b7074f9a5130d39ddcca90f",
      "path": "test/note.md",
      "size": 11,
      "content_sha256": "64ec88ca00b268e5ba1a35678a1b5316d212f4f366b2477232534a8aeca37f3c",
      "version": 1,
      "metadata": {},
      "created_at": "2026-05-18T15:34:26.494349Z",
      "updated_at": "2026-05-18T15:34:26.494349Z"
    }
  ],
  "first_id": "mem_019e3bb965a671fca51bde1cf8d87de0",
  "last_id": "mem_019e3bb965a671fca51bde1cf8d87de0",
  "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 をまたいだ永続メモリを与える。