Copy

GET /api/v1/cloud/memory_stores Memory Store を新しい順に一覧表示します。

ヘッダー

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

クエリパラメータ

パラメータ	型	必須	説明
`limit`	integer	いいえ	1〜100、デフォルトは 20
`page`	string	いいえ	前回の `next_page` 値から得られる不透明なカーソル
`name`	string	いいえ	ストア名に対する大文字小文字を区別しない前方一致フィルタ
`include_archived`	boolean	いいえ	`true` の場合、アーカイブ済みのストアを含めます。デフォルトは `false`
`created_at[gte]`	string	いいえ	RFC 3339 タイムスタンプ、下限（値を含む)
`created_at[lte]`	string	いいえ	RFC 3339 タイムスタンプ、上限（値を含む)
`after_id`	string	いいえ	この ID より後のレコードを取得するカーソル
`before_id`	string	いいえ	この ID より前のレコードを取得するカーソル

page は after_id および before_id と併用できません。after_id と before_id も同時に指定できません。limit が 100 を超えると 400 invalid_request_error を返します。

リクエスト例

curl "https://api.qoder.com/api/v1/cloud/memory_stores?limit=10" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

レスポンス

{
  "data": [
    {
      "id": "memstore_019e5cdb9c3f71c3b6505eba937a40b4",
      "created_at": "2026-05-18T08:00:00.000Z",
      "name": "project-alpha-memory",
      "type": "memory_store",
      "updated_at": "2026-05-18T08:00:00.000Z",
      "archived_at": null,
      "description": "Agent knowledge base for project Alpha",
      "metadata": {"team": "backend"},
      "status": "active",
      "entry_count": 3,
      "total_size": 1024
    }
  ],
  "has_more": true,
  "first_id": "memstore_019e5cdb9c3f71c3b6505eba937a40b4",
  "last_id": "memstore_019e5cdb9c3f71c3b6505eba937a40b4",
  "next_page": "page_bWVtc3RvcmVfMDE5ZTVjZGI..."
}

これ以上結果がない場合、has_more は false、next_page は null になります。

エラーコード

HTTP	type	発生条件
400	`invalid_request_error`	`limit` またはタイムスタンプ形式が無効、あるいは `before_id` と `after_id` が同時に指定されています
401	`authentication_error`	認証トークンが未指定または無効です

エラーエンベロープの詳細はエラーを参照してください。

ページネーション

結果はリソース ID の降順です。最初のリクエストで limit を指定し、has_more が true なら次のリクエストの page に next_page を渡します。ID ベースの場合は after_id=<last_id> または before_id=<first_id> を使用できます。

レスポンスフィールド

フィールド	型	説明
`data`	array	Memory Store オブジェクトの配列
`has_more`	boolean	続きのレコードがあるかどうか
`first_id`	string\|null	現在のページの先頭 ID。空の場合は `null`
`last_id`	string\|null	現在のページの末尾 ID。空の場合は `null`
`next_page`	string\|null	次のページのカーソル。続きがない場合は `null`

​ヘッダー

​クエリパラメータ

​リクエスト例

​レスポンス

​エラーコード

​ページネーション