Memory Store のアーカイブ

active 状態の Memory Store をアーカイブします。アーカイブ後も読み取りは可能ですが、Memory エントリの作成や更新はできません。 アーカイブ前にマウント関係が確認されます。 Store がいずれかの (identity, template) にマウントされていると 409 が返されます。すべてのマウントを解除してからアーカイブしてください。

パス

POST /api/v1/forward/memory_stores/{memory_store_id}/archive

ヘッダー

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

リクエストボディは不要です。

パスパラメータ

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

リクエスト例

curl -X POST "https://api.qoder.com/api/v1/forward/memory_stores/memstore_00mc7mukn7lkxr454tjd/archive" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

レスポンス例

HTTP 200 OK

{
  "id": "memstore_00mc7mukn7lkxr454tjd",
  "type": "memory_store",
  "name": "project-alpha-memory",
  "description": "Agent knowledge base for project Alpha",
  "status": "archived",
  "entry_count": 12,
  "total_size": 4096,
  "metadata": {"created_by": "forward", "team": "backend"},
  "system_managed": false,
  "identity_id": null,
  "created_at": "2026-08-14T10:00:00Z",
  "updated_at": "2026-08-14T11:00:00Z",
  "archived_at": "2026-08-14T11:00:00Z",
  "binding_info": {"identity_template_count": 0}
}

レスポンス

アーカイブ後の Memory Store オブジェクトを返します。status は archived になり、archived_at が設定されます。

注意事項

システム管理のデフォルト Store（system_managed=true）をアーカイブすると、次にその (identity, template) で Session を作成した際に空のデフォルト Store が新規作成され、過去の Memory は孤立します。不要であることを確認できない限り、デフォルト Store をアーカイブしないでください。

エラー

HTTP	Type	発生条件
400	`invalid_request_error`	パスパラメータが無効です。
401	`authentication_error`	認証トークンがないか無効です。
403	`permission_error`	呼び出し元にこのリソースへのアクセス権限がありません。
404	`not_found_error`	Store が存在しないか、別ユーザーのため参照できません。
409	`conflict_error`	Store はすでにアーカイブ済みか、`(identity, template)` にマウントされています。
500/502/503	`api_error`	Forward または依存サービスでエラーが発生しました。

​パス

​ヘッダー

​パスパラメータ

​リクエスト例

​レスポンス例

​レスポンス

​注意事項

​エラー