Docs menu · Reference

Reads one node by id, returning its properties, declared object type, entity binding, and last-write commit coordinates. A removed or never-written node reads back as no data. Accepts as_of for time travel.

Optional reads distinguish present data from missing data. When version or timestamp facts exist on the executor output, SDK mappings should preserve them.

Examples

Read a node’s properties, or nothing if absent.

CLI

$ strata graph create social
$ strata graph add-node social alice --object-type person --properties {"age":30}
$ strata graph get-node social alice
$ strata graph get-node social absent

Wire

{"graph":"social","type":"graph_create"}
{"graph":"social","node_id":"alice","object_type":"person","properties":{"age":30},"type":"graph_add_node"}
{"graph":"social","node_id":"alice","type":"graph_get_node"}
{"graph":"social","node_id":"absent","type":"graph_get_node"}

Parameters

NameTypeRequiredDescription
as_ofintegernoOptional timestamp in microseconds. Reads the graph state visible at that instant.
graphstringyesGraph name.
node_idstringyesNode id.

Plus the optional scope: branch and space (default to the session branch and the "default" space).

Returns

Maybe<GraphNodeDataOutput> — a miss returns nothing rather than raising.

Errors

Invocation

  • CLI: strata graph get-node
  • Wire type: graph_get_node

agents: this page as markdown → /docs/reference/graph/node/get.md