Illustrative contract
Ask for memory in a named context.
A future-facing integration can name the subject, agent, scope, and task, then receive qualified context with citations and state. The exact route, field names, enums, and response shape below are not a public API promise.
Illustrative only. The closed-beta API currently exposes authenticated source ingestion and upload, durable job polling, wiki search/read/query, explicit capture, and scoped Hermes memory search. The public people-memory SDK contract is still being designed.
illustrative · not releasedPOST /illustrative/v1/memory/search
Authorization: Bearer ••••••••
{
"subject": "maya-chen",
"agent": "customer-success",
"scope": "northstar-account",
"task": "prepare executive review",
"include": ["current", "conflicting", "provenance"]
}200 OK
{
"status": "qualified",
"memories": [
{
"statement": "Adoption replaced seats as the renewal measure.",
"state": "current",
"confidence": "supported",
"citations": [{ "source": "capture-184", "observed_at": "2026-06-18" }]
}
],
"authority": "context_only"
}