Products

Get an optimal decision

Give Algenta your inputs and constraints. Get back the optimal action with confidence, risk, and plain-English reasoning.

Evaluates thousands of possible scenarios in milliseconds using the Algenta API — no statistics or simulation expertise required.

post/v1/decision

Request

  • Base URL: https://api.algenta.ai
  • URL: https://api.algenta.ai/v1/decision
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Request body

objectivestring

What to optimize: maximize_value, minimize_risk, maximize_profit, minimize_cost

risk_tolerancestring

How much risk is acceptable: low, medium, high

scenariosinteger

How many scenarios to evaluate (more = higher confidence)

enginestring

Simulation engine. 'auto' (default) selects the best engine automatically based on your data shape. Options: monte_carlo, lhs, qmc_sobol, bootstrap, mcmc, importance_sampling, time_series, sensitivity

labelstring nullable

Optional label for this decision

Example request

{
  "inputs": [
    {
      "high": 180000,
      "low": 80000,
      "name": "revenue",
      "unit": "USD",
      "value": 120000
    },
    {
      "high": 100000,
      "low": 50000,
      "name": "cost",
      "unit": "USD",
      "value": 70000
    }
  ]
}

Response

Successful Response

decision_idstring required
actionstring required

Recommended action: proceed, pause, reject, or custom

confidencenumber required

Confidence in this recommendation (0–1)

reasoningstring required

Plain-English explanation

whystring[] required

3 crisp reasons behind this recommendation

expected_outcomenumber required

Expected value in your input units

downside_risknumber required

Value at 5th percentile (worst-case)

upside_potentialnumber required

Value at 95th percentile (best-case)

probability_of_lossnumber required

Probability of negative outcome

scenarios_evaluatedinteger required
latency_msnumber required

Changes

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