forget
ファクトを1件削除します。
POST/v1/forget
MCPでも forget ツールとして利用できます。
まずrecallでファクトを見つけ、その subject、predicate、ref を渡します。
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
subject | string | はい | 主語。保存されているとおりに指定します。 |
predicate | string | はい | 述語。WorksAt でも works_at が見つかります。 |
ref | string | はい | ファクトIDの末尾5文字、またはID全体。 |
collection | string | いいえ | コレクションコード。省略すると接続時のデフォルト値を使い、"" はデフォルト領域を強制します。 |
リクエスト
{
"subject": "user:maya",
"predicate": "works_at",
"ref": "X2C9A"
}
応答
deleted には削除されたファクトが入ります。
{
"deleted": { "id": "01KJ8Z3W5Q2YB7N4R6T8VX2C9A", "ref": "X2C9A", "subject": "user:maya", "predicate": "works_at", "object": "company:acme" }
}
エラー
| ステータス | 条件 |
|:--|:--|
| 400 | ref がIDの5文字・26文字のどちらでもない |
| 404 | 一致するファクトがなく、何も削除されていない |
| 409 | 2件のファクトが同じrefを持ち、何も削除されていない。ref にID全体を指定してください |
forget_entity
エンティティが主語または目的語であるファクトをすべて削除し、ほかから参照されていなければエンティティ自体も削除します。RESTの POST /v1/forget_entity とMCPの forget_entity ツールで利用できます。
POST/v1/forget_entity
{ "entity": "user:maya" }
応答には facts_deleted と entity_deleted が含まれます。