Graph export

Exports the whole knowledge graph of a dataset as JSON: every entity and every edge. Use it to inspect, visualize, back up or migrate what remember has built. It reads the database only and makes no LLM call, so it works even when no LLM is configured.

Request

GET /v1/gb/datasets/main/graph?user_id=u1

Part	Required	Description
`{name}` (path)	yes	Dataset name.
`user_id` (query)	yes	Owner of the dataset (see Identity).

Only the owner’s live dataset can be exported. Datasets of other users, and soft-deleted ones, are not visible.

Response

200 with content-type: application/json:

{
  "dataset": "main",
  "entities": [
    {"id": 1, "name": "Alice", "type": "person", "description": "Software engineer", "model_id": "5496d6743cdde4fe"},
    {"id": 2, "name": "Acme", "type": "organization", "model_id": "5496d6743cdde4fe"}
  ],
  "edges": [
    {
      "id": 1,
      "source_id": 1,
      "target_id": 2,
      "source": "Alice",
      "target": "Acme",
      "relation": "works_at",
      "description": "Alice works at Acme.",
      "artifact_id": 1,
      "model_id": "5496d6743cdde4fe",
      "valid_at": "2024-01-01T00:00:00Z",
      "created_at": "2025-06-01T10:00:00Z"
    }
  ],
  "models": [
    {"id": "5496d6743cdde4fe", "name": "claude-haiku-5-5", "provider": "anthropic", "kind": "llm", "supported": true, "created_at": "2025-05-01T09:00:00Z"}
  ]
}

Entities (nodes)

Field	Description
`id`	Entity ID, unique within the export. Edges refer to it.
`name`	Entity name.
`type`	Lowercase type (`person`, `organization`, `other`, …).
`description`	Optional; omitted if empty.
`model_id`	Optional; the ID of the model that inferred the entity (see `models`): the model of the `extract_graph` stage of the `remember` call, which the caller can pick per call (see Remember). For a shared entity it is the model that wrote its stored state: its creator, then whoever last replaced its description. Omitted if unknown.

Models

The models that the entities and edges refer to by model_id.

Field	Description
`id`	Model ID: derived from the name alone (first 8 bytes of the SHA-256 of the lowercased name, hex), so it is the same in every database.
`name`	The model name as the provider’s API reports it, e.g. `claude-haiku-5-5`.
`provider`, `kind`	`anthropic` / `openai`; `llm` / `embedding`.
`supported`	True for a model gligabao supports (stored on every startup), false for one only seen in an API response.

Edges

Field	Description
`id`	Edge ID.
`source_id`, `target_id`	IDs of the entities the edge connects (direction: source to target).
`source`, `target`	Names of those entities, for convenience. Names are not unique (the same name can have different types), so use the IDs to link nodes.
`relation`	Lowercase relation with `_` for spaces, e.g. `works_at`.
`description`	Optional; the fact as a sentence.
`artifact_id`	Optional; the artifact (the ingested text) the edge came from.
`model_id`	Optional; the ID of the model that inferred the fact (see `models`): the model of the `extract_graph` stage of the `remember` call that created it, which the caller can pick per call (see Remember). Omitted if unknown.
`valid_at`, `invalid_at`	When the fact became true and when it stopped being true (omitted while unknown or still true).
`created_at`, `expired_at`	When the fact was learned and when it was found superseded (omitted if not).

All timestamps are RFC 3339 in UTC. See Temporal facts for the meaning of the temporal fields.

Notes

entities and edges are ordered by id.
All edges are exported, including superseded ones. To get only the facts that are currently true, keep edges without invalid_at and expired_at.
Entities with no edges are included.
The graph of an empty dataset is {"dataset": "...", "entities": [], "edges": []}. The lists are never null.
The export is not paginated; it contains the full graph in one response.

Errors

Status	Meaning
`400`	`user_id` is missing or invalid.
`404`	The user has no live dataset with that name (it never existed, was deleted, belongs to another user, or the name is invalid).
`500`	Database error.

Errors are {"error": "..."}.

Example

curl 'http://localhost:7878/v1/gb/datasets/main/graph?user_id=u1' > graph.json

Memory

Data

Service

Request

Response

Entities (nodes)

Models

Edges

Notes

Errors

Example

​Request

​Response

​Entities (nodes)

​Models

​Edges

​Notes

​Errors

​Example

Request

Response

Entities (nodes)

Models

Edges

Notes

Errors

Example