ExecuteGraphRequest

Request body for POST /execute/graph.

Executes a pre-compiled graph directly, bypassing the compilation step. Use the hot path: compile once at startup → cache graph_id → call this endpoint on every evaluation.

ir_hash, if provided, is verified against the stored graph before execution. Mismatch → HTTP 409 (audit trail mechanism; signals stale graph_id in caller).

graph_idGraph Id (string)required

entityEntity (string)required

ir_hash object

anyOf

• string
• null

string

timestamp object

anyOf

• string
• null

string

explainExplain (boolean)

Default value: false

explain_modeExplainMode (string)

Verbosity level for concept execution explanations.

summary — final output + top contributions only full — contributions + per-node trace (default) debug — full trace + raw intermediate values

Possible values: [summary, full, debug]

Default value: full

cacheCache (boolean)

Default value: true

missing_data_policy object

anyOf

• MissingDataPolicy
• null

MissingDataPolicy (string)

Policy applied when a primitive fetch returns no data for an entity.

null — return null (T?); downstream operators must handle nullable zero — substitute 0; forces non-nullable output forward_fill — use last known value (non-nullable) backward_fill — use next known value (non-nullable)

Specified per-request to override per-primitive defaults.

Possible values: [null, zero, forward_fill, backward_fill]

ExecuteGraphRequest

{
  "graph_id": "string",
  "entity": "string",
  "ir_hash": "string",
  "timestamp": "string",
  "explain": false,
  "explain_mode": "full",
  "cache": true,
  "missing_data_policy": "null"
}