All endpoints require auth.

​
Users

GET /v1/users → { "users": [...], "count": int, "current": "<user_id>" }. Each user includes activity metadata (sessions, domains, role, first-seen).

​
Workspaces

​
List

GET /v1/workspaces → { "workspaces": [...], "current": "<org_id>" }. The current org is auto-registered on read.

​
Create

POST /v1/workspaces
​
id
string
required
​
name
string | null
Returns the created workspace. 400 on an invalid or duplicate id.

​
Per-user memory

​
Remember

POST /v1/user/remember — requires a user_id (from JWT or X-User-Id).
​
key
string
required
​
value
string
required
​
confidence
number
default:"0.7"
Returns { "node_id", "key" }. 400 if the user id is missing.

​
Recall

POST /v1/user/recall — requires a user_id.
​
question
string
required
​
budget_tokens
integer | null
Returns { "spans": [...], "total_tokens": int }.