Risk Evaluator

The Risk Evaluator builds structured risk sessions around any business decision. Each session tracks a probability-weighted scenario tree that evolves as you apply real-world events, select branches, and have agents debate nodes.

Typical flow: Create session → Generate tree → (optional) Apply events → Select branch → Export JSON

Create a new risk evaluation session for a decision or scenario you want to model.

Request body

Name	Type	Required	Description
`title`	`string`	required	Short title for this session
`description`	`string`	optional	The decision or scenario being evaluated

Response

{
  "session": {
    "id": "risk_abc",
    "title": "Series A fundraise risks",
    "description": "Evaluating risks for our Q3 raise",
    "createdAt": "2026-06-04T09:00:00Z"
  }
}

List all risk evaluation sessions in your workspace.

Response

{
  "sessions": [
    {
      "id": "risk_abc",
      "title": "Series A fundraise risks",
      "description": "Evaluating risks for our Q3 raise",
      "createdAt": "2026-06-01T09:00:00Z",
      "updatedAt": "2026-06-02T14:30:00Z"
    }
  ]
}

Get a full risk session including state history, scenario tree, and all tracked events.

Path / Query parameters

Name	Type	Required	Description
`id`	`string`	required	Risk session ID

Response

{
  "session": {
    "id": "risk_abc",
    "title": "Series A fundraise risks",
    "scenarioTree": { "nodes": [...], "edges": [...] },
    "stateHistory": [ ... ],
    "events": [ ... ]
  }
}

Generate an AI scenario tree for this session. Agents model probability-weighted branches of outcomes. Consumes AI tokens.

Path / Query parameters

Name	Type	Required	Description
`id`	`string`	required	Risk session ID

Request body

Name	Type	Required	Description
`depth`	`number`	optional	Tree depth (default 3). Higher values use more tokens.
`branchingFactor`	`number`	optional	Number of branches per node (default 3)

Response

{
  "session": {
    "id": "risk_abc",
    "scenarioTree": {
      "nodes": [
        { "id": "n_root", "label": "Launch Series A", "probability": 1.0 },
        { "id": "n_1", "label": "Term sheet signed", "probability": 0.65 },
        { "id": "n_2", "label": "Process stalls", "probability": 0.35 }
      ],
      "edges": [ { "from": "n_root", "to": "n_1" }, { "from": "n_root", "to": "n_2" } ]
    }
  }
}

Apply a real-world event to the session. The AI re-evaluates node probabilities based on the new information.

Path / Query parameters

Name	Type	Required	Description
`id`	`string`	required	Risk session ID

Request body

Name	Type	Required	Description
`label`	`string`	required	Short event label (e.g. "Key investor passed")
`description`	`string`	optional	More context about this event
`impact`	`string`	optional	"low" \| "medium" \| "high" — estimated impact severity

Response

{
  "session": {
    "id": "risk_abc",
    "events": [
      { "label": "Key investor passed", "impact": "high", "appliedAt": "2026-06-04T11:00:00Z" }
    ]
  }
}

Mark a scenario tree node as the active branch. Used to track which path has actually occurred so the tree can be recomputed from that node forward.

Path / Query parameters

Name	Type	Required	Description
`id`	`string`	required	Risk session ID

Request body

Name	Type	Required	Description
`nodeId`	`string`	required	ID of the node to select as the active branch

Response

{
  "session": {
    "id": "risk_abc",
    "activeNodeId": "n_1"
  }
}

Export the full session as a JSON file. Includes the scenario tree, all events, state history, and agent comments. Response is sent as a downloadable attachment.

Path / Query parameters

Name	Type	Required	Description
`id`	`string`	required	Risk session ID

Response

// Returns: application/json download
// Content-Disposition: attachment; filename="risk-session-{id}.json"
{
  "session": { ... },
  "tree": { "nodes": [...], "edges": [...] },
  "events": [...],
  "comments": [...]
}

Permanently delete a risk session and its scenario tree. Returns 200 { success: true }.

Path / Query parameters

Name	Type	Required	Description
`id`	`string`	required	Risk session ID