Counterfactuals

Evaluate what-if scenarios for a stored decision

Runs labeled simulation-only scenarios against the current Decision API runtime. Counterfactuals do not authorize downstream mutation; use the returned diffs for planning, rollout review, and policy tuning.

post/api/decision/{decision_id}/counterfactuals

Request

  • Base URL: https://www.decide.fyi
  • URL: https://www.decide.fyi/api/decision/{decision_id}/counterfactuals
  • Auth: API key in header x-api-key

Path parameters

decision_idstring required

Headers

x-decision-response-view'minimal' | 'standard' | 'full'

Request body

response_view'minimal' | 'standard' | 'full'

Response

Counterfactual report

okboolean required
decision_counterfactuals_version'decision_counterfactuals_v1' required
generated_atstring
source_decision_idstring required
simulation_onlytrue required
baselineobject required
scenario_countinteger
evaluated_countinteger
changed_countinteger
data_qualityobject
counterfactual_hashstring required

Changes

No recorded changes to this operation across all 1 revision of this API.