Api / Memory

GET/v1/memory/graph

Auth: tenant — Status: stable

Single bulk fetch — entries plus relations in one round trip. The frontend calls this on mount to hydrate the force graph. The graph reflects the curated, directly-written set of entries and relations.

Request

Query parameters

NameTypeDescription
typecsv stringFilter entries to these types; relations are pruned to those whose endpoints both survive the filter, so the snapshot stays self-consistent.
curl -H "Authorization: Bearer atr_…" \
  http://arbiter.example.com/v1/memory/graph

Response

200 OK

{
  "tenant_id": 1,
  "entries":   [ ... ],
  "relations": [ ... ]
}

entries[] and relations[] carry the standard shapes — see Data model.

No pagination in v1 — the unfiltered set is expected to fit in one response. The entry sweep caps the snapshot at the per-page entry ceiling (200); when a tenant outgrows that we'll add cursor support.

Failure modes

StatusWhenBody
400type value not in enum.{"error": "..."}
401Missing / invalid bearer.{"error": "..."}

See also