Causalor / Niyati
← Back

Hosted API

The live engine surface.

The production API serves health, readiness, metrics, a theorem-rich simulation endpoint, and six keyed solve routes.

Base URL

https://api.causalorlabs.com

Health Routes

  • GET /healthz
  • GET /readyz
  • GET /metrics
Access model

/v1/simulate is anonymous-friendly. Every /v1/solve/* route requires a valid API key. The service still accepts the legacy X-Causalor-* headers during migration, but the primary contract is Niyati.

Protected Routes

Route Purpose
POST /v1/simulate The theorem-rich universal entry point for reachability and collapse intelligence.
POST /v1/solve/reachability Exact or bounded reachable-set analysis.
POST /v1/solve/fragility Geometric collapse risk, thickness, and kappa.
POST /v1/solve/trajectory Max-bottleneck path selection across a graph.
POST /v1/solve/multiagent Optionality loss from interference between agents.
POST /v1/solve/competition Competitive collapse analysis and adversarial premium.
POST /v1/solve/pareto Multi-resource reachability and scalar reducibility.

Headers

Content-Type: application/json
X-Niyati-Version: 0.3.2
X-Niyati-Key: <api key>

The version header is strict. A mismatched version returns 426 Upgrade Required. The hosted API is currently on contract version 0.3.2.

Access Tiers

Anonymous

Use /v1/simulate without a key for low-friction exploration.

Developer

Registered pilot access with higher limits and all solve routes enabled.

Internal

Highest limits for demos, QA, and internal products without billing.

Simulation Response

Field Meaning
verdict possible, impossible, or invalid_schema.
recommendation Human-readable guidance from the simulation result.
point_of_no_return / goal_reached_at When the goal closed, or when it first became reachable.
recommended_path Optional best-path summary with states, bottleneck_future_width, total_cost, and reaches_goal.
timeline Per-step future width, thickness, risk spike, entropy, and structural state.
sensitivity_report Primary culprits, mean thickness, and peak fragility across the run.
critical_decisions Ranked next-step transitions and their impact ratio.
survival_policy Recommended posture based on the current regime.
dynamic_evolution Discovery counts, new state and edge totals, persistence validity, and discovery regret when theorem inputs include updates.
composition_analysis Subsystem names, volume product, minimum thickness, coupling, and independence status when subsystem inputs are present.
monotonicity_report, persistence_report, collapse_rate_report, information_value_report Audit surfaces for theorem families T2/T6/T11/T18.

Timeline Fields

  • timeline[].t
  • timeline[].future_width
  • timeline[].thickness
  • timeline[].risk_spike
  • timeline[].goal_distance - fraction of goal conditions satisfied at that step
  • timeline[].is_on_recommended_path
  • timeline[].entropy
  • timeline[].dominant_root_cause
  • timeline[].status
  • timeline[].active_constraints
  • timeline[].local_dimension
  • timeline[].phase_transition
  • timeline[].minimum_collapse_perturbation
  • timeline[].directional_margin

Solve Responses

Reachability

reachable_count, states, error_bounds.

Fragility

collapse_risk, thickness, kappa.

Trajectory

path, safety_score.

Multi-agent

agent_id, solo_optionality, conditional_optionality, optionality_loss, interfering_agents.

Competition

kappa_unperturbed, kappa_competitive_bound, adversarial_premium, tau_star.

Pareto

reachable_states, reachable_count, scalar_reducible, scalar_budget.