Give your product a Brain.

Write what happened. Ask what matters. Get current context with the sources attached.

Source records

Brain system map Records are linked across time and returned with citations. Policy Terms Plan Window Refund policy Entitlement Account state supersedes applies to cited by

Relevant records

createContextready
Text

Annual plans are eligible for a refund within 14 days.

Citations · 2

refunds-policy.md §2.1
Plan changed to Annual Pro

Unknowns · 1

No evidence for usage-based overages.

Cost

model 1 · embed 1 · gen 0

Two calls.
Records you can trace.

Remember a Record. Request Context. The response carries the relevant source text, citations, missing evidence, conflicts, and cost.

Remember a Record

rememberRecord accepts messages, documents, events, facts, and plain text.

Request Context

createContext returns the source material allowed for the task.

const remembered = await fetch(`${base}/brains/ada/records`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${key}`,
    "Content-Type": "application/json",
    "Idempotency-Key": "customer-policy-1"
  },
  body: JSON.stringify({ content: {
    kind: "document", title: "Refund policy", text: policy
  }})
});

const context = await fetch(`${base}/brains/ada/context`, {
  method: "POST",
  headers: { Authorization: `Bearer ${key}`, "Content-Type": "application/json" },
  body: JSON.stringify({ query: "What is our refund policy?",
    include: ["citations", "unknowns", "conflicts"] })
});
{
    "id": "ctx_01KYJE7NVFGKA11WPG28CTVRNA",
    "object": "context",
    "status": "ready",
    "query": "what is my home address?",
    "watermark": "wm_000000000004",
    "text": "my home address is 12 Analytical Way, Turin",
    "citations": [
        {
            "record_id": "rec_01KYJE7NQ44HR4RJ31VDV0DKKE",
            "quote": "my home address is 12 Analytical Way, Turin"
        }
    ],
    "conflicts": [],
    "unknowns": [],
    "budget": {
        "requested_tokens": 4000,
        "estimated_tokens": 10,
        "truncated": false
    },
    "cost": {
        "generative_calls": 0,
        "processing_units": 0.0
    },
    "memories": [
        {
            "id": "mem_01KYJE7NQ4Y35T92H30MKDPQFD",
            "object": "memory",
            "statement": "my home address is 12 Analytical Way, Turin",
            "subject": "record",
            "owner": {
                "state": "self",
                "entity": "Ada Lovelace"
            },
            "valid_from": "2026-07-27T18:43:42Z",
            "valid_to": null,
            "version": 1,
            "status": "active",
            "citations": [
                {
                    "record_id": "rec_01KYJE7NQ44HR4RJ31VDV0DKKE",
                    "quote": "my home address is 12 Analytical Way, Turin"
                }
            ]
        }
    ]
}
→ context text→ source records → unknowns→ conflicts→ visible cost

Five parts, each with one job.

The API keeps sources, derived findings, accepted facts, and one request's evidence separate.

01

Brain

The account boundary for one product.

createBrain · getBrain · forgetBrain
02

Record

A source item with content, origin, and time.

rememberRecord · getRecord · forgetRecord
03

Memory

A versioned finding drawn from source Records.

listMemories · getMemory
04

Object

A fact your application has accepted.

acceptObject · getObject
05

Context

The evidence returned for one request.

createContext

See every method and parameter.

When facts change,
the record shows it.

New evidence can replace old evidence without erasing the audit trail. Each request is bounded by time, source, ownership, sensitivity, and processing state.

Earlier · superseded
Statement
Annual refund window: 30 days
Valid
2025-01 → 2026-06
Source
refunds-policy v1
Confidence
high
Current
Statement
Annual refund window: 14 days
Valid
2026-07 → now
Source
refunds-policy v2
Confidence
high

For products that need a history.

Ready now—and what remains.

Available today

  • Durable customer history behind issued keys
  • OpenAPI plus generated clients
  • Playground and console
  • Visible citations, unknowns, budget, and cost

The public sandbox is disposable. Customer SpineStore is live behind issued keys.

Still in progress

  • Context memories and conflicts are incomplete
  • Object arbitration is open
  • Brain Mac Ask/Search is not cut over
  • Published service and latency SLOs
Read every current limitation →

Brain Mac reads from the same API.

The first integration is read-only. It checks the Brain, loads its profile, lists current Memories, and opens one Memory without changing Ask, Search, or writes.

See the Brain Mac integration →

getBrainConnect

Verify the Brain for this key.

getProfileSummarize

Read the current profile counts.

listMemoriesBrowse

List current Memories.

getMemoryInspect

Open one Memory by ID.

Start with the record.

Create one Brain, save one Record, and retrieve its evidence.