# メモリ削除

復元可能なforget path、または明示的に認可された破壊的モードを、監査可能なtombstoneとともに選びます。

- Canonical: https://docs.xmemo.dev/ja/docs/concepts/memory-deletion
- Locale: ja-JP
- Content-Locale: ja-JP
- Canonical-Content-Digest: 376e4e4ecb3e1fc0955b2cd5176a16a92431ecba87f15d1ded32d8ee3f15f1fd
- Edition-Digest: de3d50a23e2a42c036160e01e72e583ef01bbf921bec8e87baf79da6d8d5f19b
- Source-Revision: sha256:ae05ed5a78af519bbe1b86561e36ef07d4758d3bcae57a6df91b7e53e4f5cfff

## soft deletionが公開デフォルトです

DELETE /v1/memories/{memory_id}のデフォルトはmode=soft_deleteです。POST /v1/memories/{memory_id}/forgetは、mode、reason、replacement_content、metadataを持つ同じMemoryForgetRequest familyを受け付けます。Soft deleteはtombstoneとversion snapshotを作成し、memory statusをdeletedに変更します。その後restoreすることもできます。

```http
DELETE /v1/memories/<memory-id>?mode=soft_delete&reason=user-requested
X-API-Key: <your-assigned-api-key>
```

## Forget、redact、hard-deleteは異なるmodeです

永続化engineはsoft_delete、redact、hard_deleteを受け付けます。Redactはcontentを[REDACTED]（または指定されたreplacement content）に置き換え、metadataとembeddingを消去し、安全なredaction provenanceを記録します。Hard deleteは不可逆で、より強いmemory:hard_delete authorization pathによって保護されています。通常の修正で選ばないでください。

- soft_delete — tombstoneとversion snapshotを伴う、復元可能な削除。
- redact — 元のcontentとembeddingを除去し、非contentのtombstone/resultだけを残す処理。
- hard_delete — より強いdelete capabilityを必要とする、恒久的な削除path。

## soft-deleted memoryだけをrestoreする

POST /v1/memories/{memory_id}/restoreは、任意のreasonとmetadataを持つMemoryRestoreRequestを受け付けます。永続化pathはstatus=activeに戻してversionを増分します。Redacted memoryは元のcontentが残っていないためrestoreできません。

```http
POST /v1/memories/<memory-id>/restore
X-API-Key: <your-assigned-api-key>
Content-Type: application/json

{
  "reason": "owner-confirmed recovery"
}
```

## 削除は認可され、監査される

REST mutation pathは、targetを解決する前にmodeごとのmemory scopeとowner-scoped keyを確認します。要求されたmode、reasonの有無、target referenceをmemory tombstone/audit evidenceに記録しますが、忘れられたcontentを公開結果に含めることはありません。

## ChatGPT ユーザー

bearer token をチャットに貼り付けずに、ChatGPT が XMemo の設定、プロジェクト事実、意思決定、TODO に永続的にアクセスできるようにします。

ChatGPT/OpenAI app の OAuth フローで hosted XMemo MCP server に接続し、XMemo アカウントに memory:read と memory:write の許可を承認します。

合成の設定またはプロジェクトメモを保存し、新しいチャットを開始してから、作業を続ける前に ChatGPT に XMemo 経由でそれを呼び出させます。

OAuth が失敗する、またはツールが表示されない場合は、direct token を作成する前に、ホストアプリで MCP server からサインアウトし、XMemo server URL を再接続して再試行します。

## Copilot / Codex 開発者

リポジトリの判断、コーディング規約、バグ修正メモ、タスク履歴を IDE と CLI エージェント間で持ち運べます。

利用可能な場合は、VS Code / GitHub Copilot および Gemini CLI に OAuth を使用してください。Copilot CLI、Codex、Cursor、またはその他の直接 MCP クライアントの場合は、XMEMO_KEY をローカル環境またはシークレットストアに保持し、安定した XMEMO_AGENT_INSTANCE_ID を設定してください。

コードベースの判断またはバグ修正を記録し、次の IDE または CLI エージェントに、編集前に関連する XMemo コンテキストを呼び出させます。

呼び出し結果が空の場合は、選択した MCP 設定パス、direct client 用の XMEMO_KEY 環境変数、ホストアプリ内の古い OAuth 認証情報を確認します。

## チーム / エンタープライズ pilot owner

アカウント制御、ソース attribution、エクスポート/削除ワークフロー、レビュー担当者向けに安全な設定証跡で共有メモリを評価します。

保護された XMemo workspace を作成または開き、承認済みユーザーを招待してから、readiness badges に従って OAuth またはスコープ付き direct credential で各クライアントを接続します。

pilot メンバーに合成のチームメモリを保存してもらい、XMemo でソース attribution を確認し、削除/エクスポートとサポート経路をレビューします。

メンバーが接続できない場合は、新しい token を発行する前に、ロール権限、OAuth 承認、クライアント readiness 状態、サポートガイダンスを確認します。

## 自律エージェント operator

headless またはスケジュール済みエージェントが進捗を記録し、過去の判断を取得し、安定した非秘密のインスタンス ID を保持できるようにします。

/api/v1/mcp/config/autonomous-agent を取得します。runner が OAuth + custom headers をサポートする場合は auth_modes.oauth を優先し、完全 headless runner の場合のみ secret store の XMEMO_KEY で auth_modes.xmemo_key を使います。

XMemo に進捗を書き込む合成タスクを 1 つ実行し、runner を再起動して、同じ XMEMO_AGENT_INSTANCE_ID でその進捗を呼び出せることを確認します。

attribution が変わる、または呼び出し結果がインスタンス間で分かれる場合は、XMEMO_AGENT_INSTANCE_ID を git の外に永続化し、runner が起動ごとに再生成していないことを確認します。