POST/validate-config

Validate Config

Validate a solver configuration before running a simulation.

POST/validate-configAUTH

Validate a solver configuration and receive warnings and suggestions.

Use this endpoint to check a SolverConfig for potential issues before submitting it in a simulation request. The response indicates whether the config is valid (no warnings) and provides human-readable suggestions.

Request Body

The request body is a full SolverConfig object. See Solver Config for all fields.

json

{
  "operational": {
    "turn_minutes": 20,
    "time_block": 5,
    "max_runtime": 5
  },
  "costs": {
    "delay_min": 2,
    "swap": 50,
    "cancel_flight": 500
  },
  "strategies": ["delay"]
}

Response

json

{
  "config": { "..." },
  "valid": false,
  "warnings": [
    "Turn time below 25 minutes may be unrealistic for most aircraft types",
    "Runtime below 10 seconds may not allow solver to find good solutions",
    "Cancellation cost may be too low relative to swap cost",
    "Having multiple strategies provides better recovery options"
  ],
  "suggestions": [
    "Delay cost per minute exceeds swap cost - may heavily favor swaps over delays",
    "Cancellation cost may be too low - consider passenger impact",
    "Consider including 'delay' strategy as a baseline option"
  ],
  "validation_timestamp": "2026-04-07T12:02:00+00:00"
}

validboolean

true if no warnings were raised, false otherwise.

warningsstring[]

Issues that may cause unrealistic or poor-quality results.

suggestionsstring[]

Non-critical recommendations for better outcomes.