API reference
Every endpoint, typed.
A small, predictable REST surface. Capability-token authenticated, data-plane-direct (the browser and your agents call the Workers origin straight). Here is the map; the full OpenAPI lands alongside it.
Memory[1 / 3]
Memory endpoints.
The two-call core, plus drill-in.
| Method | Path | Purpose |
|---|---|---|
| POST | /v1/memories | remember() — capture-first; returns 202 + trace_id. |
| GET | /v1/memories/search | recall() — ranked, token-budgeted, current-truth. |
| GET | /v1/memories/:id | Fetch one fact with its full provenance. |
| GET | /v1/sources | The raw capture-first ledger (Sources). |
| GET | /v1/traces/:id | Replay a trace — extraction or retrieval. |
Governance[2 / 3]
Governance endpoints.
Promotion, conflicts, and the audit trail.
| Method | Path | Purpose |
|---|---|---|
| POST | /v1/memories/:id/promote | Promote a private fact to a shared bucket (gated). |
| POST | /v1/memories/:id/invalidate | Invalidate a fact (bi-temporal, reversible). |
| GET | /v1/audit | The hash-chained, tamper-evident mutation log. |
Identity[3 / 3]
Identity endpoints.
Capability tokens and agent principals.
| Method | Path | Purpose |
|---|---|---|
| POST | /v1/keys | Issue a scoped, attenuating capability token. |
| POST | /v1/keys/:id/revoke | Revoke a key (TTL-first + denylist). |
| GET | /v1/agents | The agent roster + delegation topology. |
Build
Two calls, then the whole surface.
Start in the Quickstart; reach for these endpoints when you need governance and identity.