Quickstart

https://api.lynx.tetryx.io

curl -s https://api.lynx.tetryx.io/healthz | jq

{ "status": "ok" }

curl -sS \
  -X POST https://api.lynx.tetryx.io/jobs \
  -H 'content-type: application/json' \
  -d '{
    "name": "my-first-batch",
    "runs_override": 5,
    "config": {
      "simulation": {
        "name": "My Simulation",
        "version": "1.0.0",
        "duration_minutes": 10
      },
      "monte_carlo": {
        "runs": 5,
        "sampling_method": "latin_hypercube"
      },
      "dispersions": {
        "mass_kg": {
          "distribution": { "type": "normal", "mean": 100.0, "std_dev": 5.0 },
          "units": "kg"
        }
      },
      "compute": {
        "container": {
          "image": "your-org/your-simulation:latest",
          "cpu_request": "1000m",
          "memory_request": "2Gi"
        },
        "max_parallel_jobs": 5,
        "job_timeout_seconds": 600
      },
      "early_termination": {
        "enabled": false,
        "check_frequency_hz": 1.0,
        "conditions": []
      },
      "telemetry": {
        "sampling_rate_hz": 10.0,
        "variables": [],
        "storage": {
          "s3_bucket": "your-telemetry-bucket",
          "s3_prefix": "runs/",
          "compression": "gzip"
        },
        "buffer_flush_interval_seconds": 30
      }
    }
  }' | jq

{
  "batch_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "total_jobs": 5,
  "estimated_completion_time_mins": null
}

curl -s https://api.lynx.tetryx.io/batches/<batch-id> | jq

{
  "batch": { "status": "Running", "total_jobs": 5, ... },
  "jobs_by_status": { "Completed": 3, "Running": 2 },
  "throughput_jobs_per_minute": 12.4
}

lynx-runner \
  --runner-id my-runner-1 \
  --name "My Runner 1" \
  --max-concurrent-jobs 4

curl -s https://api.lynx.tetryx.io/runners | jq

curl -s https://api.lynx.tetryx.io/batches/<batch-id>/results | jq

curl -s https://api.lynx.tetryx.io/jobs/<job-id>/results | jq