forget
Exclua um fact.
POST/v1/forget
Também existe a ferramenta MCP forget.
Encontre o fact com recall primeiro e passe subject, predicate e ref.
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
subject | string | sim | Sujeito, exatamente como está guardado. |
predicate | string | sim | Predicado. WorksAt encontra works_at. |
ref | string | sim | Últimos 5 caracteres do id do fact, ou o id completo. |
collection | string | não | Código da collection. Omita para usar o padrão da conexão. "" força o espaço padrão. |
Requisição
{
"subject": "user:maya",
"predicate": "works_at",
"ref": "X2C9A"
}
Resposta
deleted é o fact removido:
{
"deleted": { "id": "01KJ8Z3W5Q2YB7N4R6T8VX2C9A", "ref": "X2C9A", "subject": "user:maya", "predicate": "works_at", "object": "company:acme" }
}
Erros
| Status | Quando |
|:--|:--|
| 400 | ref não tem 5 ou 26 caracteres de id |
| 404 | Nenhum fact corresponde; nada foi excluído |
| 409 | Dois facts têm a mesma ref; nada foi excluído. Passe o id completo em ref |
forget_entity
Exclui todos os facts em que a entidade é sujeito ou objeto e, depois, a própria entidade quando nada mais a referencia. REST POST /v1/forget_entity e ferramenta MCP forget_entity.
POST/v1/forget_entity
{ "entity": "user:maya" }
A resposta inclui facts_deleted e entity_deleted.