メインコンテンツへスキップ
POST /v1/memory_stores/{memory_store_id}/archive アクティブな Memory Store をアーカイブし、更新された Memory Store オブジェクトを返します。

パスパラメータ

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

ヘッダー

ヘッダー必須
AuthorizationBearer $QODER_PATはい

リクエスト例

curl -X POST "https://api.qoder.com/api/v1/cloud/memory_stores/memstore_019e3bb8d50674d9b082b73709c29c87/archive" \
  -H "Authorization: Bearer $QODER_PAT"

レスポンス例

HTTP 200 OK
{
  "id": "memstore_019e3bb8d50674d9b082b73709c29c87",
  "type": "memory_store",
  "name": "doc-test-store",
  "description": "テスト用",
  "status": "archived",
  "entry_count": 0,
  "total_size": 0,
  "metadata": {},
  "archived_at": "2026-05-18T15:34:00.007987Z",
  "created_at": "2026-05-18T15:33:49.449264Z",
  "updated_at": "2026-05-18T15:34:00.007987Z"
}

レスポンスフィールド

フィールド説明
idstringMemory Store ID、memstore_ プレフィックス
typestring固定値 "memory_store"
namestringストア名
descriptionstringストアの説明
statusstring操作成功後は archived
entry_countintegerアクティブなメモリエントリ数
total_sizeintegerアクティブなメモリエントリの総サイズ(バイト)
metadataメタデータオブジェクトカスタムメタデータ
archived_atstringUTC アーカイブ時刻
created_atstringUTC 作成時刻
updated_atstringUTC 最終更新時刻

注意事項

リクエストボディは不要です。アーカイブ後もストアは読み取り可能ですが、エントリの作成や更新はできません。

エラーレスポンス

HTTPtype説明
401authentication_error認証トークンが提供されていないまたは無効
404not_found_error指定 ID の Memory Store が存在しない
409conflict_errorMemory Store はすでにアーカイブ済み

関連項目

Memory Stores

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