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.

Store raw events (or one text message)

/v1/rememberPOST
Returns once the events are durably appended and hash-chained. Turning them into memory happens right after; poll GET /v1/jobs/{jobId}. Safe to retry with the same idempotency keys.
Authorization
bearer *Bearer <token>
API key of the form kaibo_<id>.<secret>. Scopes: read, write, read_write, forget, admin.
Request Bodyapplication/jsonrequired
streamId?string
Default: "default"Min length: 1Max length: 128
events?object[]
Min items: 1Max items: 100
Show item properties
idempotencyKey *string
Min length: 1Max length: 255
occurredAt?string (date-time)
source *object
Show properties
kind *"message" | "tool_call" | "file" | "commit" | "system" | "import"
agent?string
Min length: 1Max length: 128
uri?string
Min length: 1Max length: 2048
payload *object
blobRef?string
Min length: 1Max length: 512
text?string
Min length: 1Max length: 262144
scope?"org" | "project" | "agent" | "user" | "session"
Default: "project"
idempotencyKey?string
Min length: 1Max length: 255
Response
200 · Replayed: nothing new was appended
Replayed: nothing new was appended
201 · Success
eventIds *string[]
streamId *string
Min length: 1Max length: 128
firstSeq *integer
Min: 1Max: 9007199254740991
lastSeq *integer
Min: 1Max: 9007199254740991
headHash *string
Pattern: ^[0-9a-f]{64}$
jobId *string
Min length: 1Max length: 128
replayed *integer
Min: 0Max: 9007199254740991
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/remember" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
  "streamId": "default",
  "events": [
    {
      "idempotencyKey": "string",
      "occurredAt": "2024-01-15T09:30:00Z",
      "source": {
        "kind": "message",
        "agent": "string",
        "uri": "string"
      },
      "blobRef": "string"
    }
  ],
  "text": "string",
  "scope": "org",
  "idempotencyKey": "string"
}'