Skip to Content
Aionis v0.3.2 is the current Runtime baseline for SDK/API hosts, MCP clients, plugins, Substrate-backed recall, and self-managed agent loops.
API ReferenceMemory GovernanceForget

Forget

POST /v1/forget

Suppress, unsuppress, or lifecycle-control memory with an auditable reason.

Use this endpoint when a host or operator knows that memory should no longer be eligible for direct action, or that a reviewed suppression should be restored.

Request body

FieldTypeRequiredDescription
operationsuppress, unsuppress, rehydrate, or activateYesLifecycle operation to apply.
targetpattern, archive, payload, or memoryYesTarget class.
reasonstringYesAudit reason for the operation.
tenant_idstringNoTenant boundary.
scopestringNoProject or workspace boundary.
actorstringNoHuman, service, or Agent applying the change.
memory_ids / node_idsstring[]ConditionalRuntime memory references.
client_idsstring[]ConditionalClient-provided write IDs.
guide_trace_idstringNoGuide trace connected to the decision.
untilstringNoOptional ISO timestamp for temporary suppression.

At least one target reference should be supplied.

Example: suppress memory

curl -s http://127.0.0.1:3001/v1/forget \
  -H 'content-type: application/json' \
  -d '{
    "tenant_id": "default",
    "scope": "checkout-migration",
    "operation": "suppress",
    "target": "memory",
    "reason": "This memory was contradicted by the accepted verifier result.",
    "memory_ids": ["mem_123"],
    "actor": "reviewer-1"
  }'

Example: restore after review

curl -s http://127.0.0.1:3001/v1/forget \
  -H 'content-type: application/json' \
  -d '{
    "tenant_id": "default",
    "scope": "checkout-migration",
    "operation": "unsuppress",
    "target": "memory",
    "reason": "Manual review confirmed this memory is current.",
    "memory_ids": ["mem_123"],
    "actor": "reviewer-1"
  }'

SDK

await aionis.forget({
  operation: "suppress",
  target: "memory",
  reason: "Contradicted by accepted verifier result.",
  memory_ids: ["mem_123"],
  actor: "reviewer-1",
});

Response

Important fields:

FieldMeaning
contract_versionLifecycle result contract version.
operationApplied operation.
targetTarget class.
forget_effectAudit record and lifecycle effect.
source_mapRuntime surfaces used to apply the operation.
RehydrateOverview