---
title: "Run AI Business Case Engine (10 credits)"
method: POST
path: "/api/v1/engines/ai-business-case/run"
---

# Run AI Business Case Engine (10 credits)

`POST /api/v1/engines/ai-business-case/run`

## Request

- Base URL: `https://signalband.net`
- URL: `https://signalband.net/api/v1/engines/ai-business-case/run`
- Auth: HTTP bearer

Decides which AI initiatives have earned funding: evidence-adjusted benefit, a 12-month token, inference and licence spend forecast as P10/P50/P90, adjusted ROI, six red flags and a Fund / Pilot / Stop decision per initiative.

## Request body

- object
  - `currency` string
  - `aiBudgetMonthly` number
  - `evidenceWeight` number
  - `runs` integer
  - `seed` integer
  - `modelPricing` object: Tier name -> [input $/M tokens, output $/M tokens]
  - `initiatives` object[], required
    - `id` string, required
    - `name` string, required
    - `owner` string
    - `stage` string
    - `modelType` 'LLM API' | 'SaaS copilot' | 'Classic ML', required
    - `modelTier` string
    - `claimedAnnualBenefit` number, required
    - `baselineMeasured` boolean, required
    - `benefitMetric` string, required
    - `monthlyRequests` number
    - `inputTokensPerRequest` number
    - `outputTokensPerRequest` number
    - `seats` number
    - `seatPrice` number
    - `platformMonthly` number
    - `peopleAnnual` number
    - `oneOffBuild` number
    - `monthsToFullAdoption` number
    - `monthsOperational` number: Months fully operational (live initiatives)
    - `trend` 'Improving' | 'Flat' | 'Declining'
    - `claims` object[], required
      - `id` string
      - `text` string, required
      - `benefitShare` number, required
      - `evidence` object[], required
        - `type` 'Vendor claim' | 'Demo' | 'Staff survey' | 'Expert estimate' | 'Pilot telemetry' | 'Backtest' | 'A/B test' | 'Production data', required
        - `direction` 'Supports' | 'Contradicts' | 'Neutral', required
        - `summary` string
        - `observedShare` number: Share of the claimed effect actually measured, e.g. 0.9

## Response `200`

Result with provenance

- RunResult
  - `engine` string
  - `result` object
  - `creditsUsed` integer
  - `provenance` object

## Other responses

- `401`: Error
- `402`: Error
- `422`: Error
- `429`: Error

---

[API](https://skmtc.dev/signalband/apis/signal-band-decision-engines.md) · [All operations](https://skmtc.dev/signalband/apis/signal-band-decision-engines/llms.txt) · [OpenAPI document](https://skmtc.dev/signalband/apis/signal-band-decision-engines/revisions/be73c95c8797?raw)