Agent-readable docs index: /docs/llms.txt. Full docs in one file: /docs/llms-full.txt. Download /docs/docs.zip to grep all markdown files locally.

Forget by memory id or by query

/v1/forgetPOST
Tombstones immediately (recall stops returning it) and purges the text after a grace window. With dryRun: true it only lists matches. Returns a receipt that can be verified against the deletion ledger. Needs a key with the forget scope.
Authorization
bearer *Bearer <token>
API key of the form kaibo_<id>.<secret>. Scopes: read, write, read_write, forget, admin.
Request Bodyapplication/jsonrequired
memoryId?string
Min length: 1Max length: 128
query?string
Min length: 1Max length: 8000
reason *string
Min length: 1Max length: 500
dryRun?boolean
Response
200 · Success
Any of:
Option 1
receipt *object
Show properties
id *string
Min length: 1Max length: 128
memoryIds *string[]
Min items: 1
reason *string
tombstonedAt *string (date-time)
purgeAt *string (date-time)
purgedAt *string (date-time) | null
ledgerSeq *integer
Min: 1Max: 9007199254740991
ledgerHash *string
Pattern: ^[0-9a-f]{64}$
Option 2
dryRun *true
matches *object[]
Show item properties
memoryId *string
Min length: 1Max length: 128
type *"fact" | "decision" | "task" | "preference" | "procedure" | "episode"
content *string
400 · Invalid request
error *object
Show properties
code *"unauthenticated" | "forbidden" | "not_found" | "invalid_request" | "conflict" | "idempotency_mismatch" | "payload_too_large" | "rate_limited" | "internal"
message *string
requestId *string
details?object
401 · Missing, malformed, revoked or expired key
error *object
Show properties
code *"unauthenticated" | "forbidden" | "not_found" | "invalid_request" | "conflict" | "idempotency_mismatch" | "payload_too_large" | "rate_limited" | "internal"
message *string
requestId *string
details?object
403 · The key lacks the required scope
error *object
Show properties
code *"unauthenticated" | "forbidden" | "not_found" | "invalid_request" | "conflict" | "idempotency_mismatch" | "payload_too_large" | "rate_limited" | "internal"
message *string
requestId *string
details?object
429 · Rate limited. See Retry-After
error *object
Show properties
code *"unauthenticated" | "forbidden" | "not_found" | "invalid_request" | "conflict" | "idempotency_mismatch" | "payload_too_large" | "rate_limited" | "internal"
message *string
requestId *string
details?object
Request example
curl -X POST "/v1/forget" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
  "memoryId": "string",
  "query": "string",
  "reason": "string",
  "dryRun": true
}'