ExecuteRequest

Request body for POST /execute.

timestamp presence controls execution mode: present → deterministic mode; result.deterministic=True; result is cached. absent → snapshot mode; result.deterministic=False; result must NOT be cached beyond the current request (SNAPSHOT cache key rule).

explain=True populates ConceptResult.explanation. The explain_mode controls verbosity. 'full' is the default and returns contributions + node trace.

idId (string)required

versionVersion (string)required

entityEntity (string)required

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]

ExecuteRequest

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