List of all active API endpoints supported by the ML Runtime. All endpoints require `X-API-Key` auth header except `/health` and `/`.
| Method | Endpoint (Dual-Prefix Supported) | Auth | Description |
|---|---|---|---|
| GET | /health /api/v1/runtime/ml/health |
Public | Public service health check. Returns {"status": "ok"}. |
| GET | / |
Public | Renders the Developer Playground testing dashboard. |
| POST | /api/v1/models/train /api/v1/runtime/ml/models/train |
X-API-Key | Creates a training job record, downloads CSV, preprocesses features, trains registered models, and saves the best pipeline. |
| GET | /api/v1/models /api/v1/runtime/ml/models |
X-API-Key | Lists metadata and metrics for all trained models. |
| GET | /api/v1/models/{model_id} /api/v1/runtime/ml/models/{model_id} |
X-API-Key | Retrieves detailed metadata for a single model (hides filesystem paths). |
| DELETE | /api/v1/models/{model_id} /api/v1/runtime/ml/models/{model_id} |
X-API-Key | Deletes the database metadata registry and local model .joblib artifact binary. |
| POST | /api/v1/models/{model_id}/predict /api/v1/runtime/ml/models/{model_id}/predict |
X-API-Key | Performs inference for a single record input payload or a batch dataset URL. Aligns features dynamically. |
| POST | /api/v1/models/{model_id}/evaluate /api/v1/runtime/ml/models/{model_id}/evaluate |
X-API-Key | Evaluates model performance metrics on an external test dataset URL. |
| GET | /api/v1/models/{model_id}/metrics /api/v1/runtime/ml/models/{model_id}/metrics |
X-API-Key | Returns model performance metrics and model search histories. |
| GET | /api/v1/models/{model_id}/schema /api/v1/runtime/ml/models/{model_id}/schema |
X-API-Key | Returns validation schema parameters including target column, numeric and categorical splits. |
| POST | /api/v1/models/{model_id}/explain /api/v1/runtime/ml/models/{model_id}/explain |
X-API-Key | Feature importance explorer. Extracts model feature importances (or coefficients). |
| GET | /api/v1/models/{model_id}/sample-input /api/v1/runtime/ml/models/{model_id}/sample-input |
X-API-Key | Returns a sample feature dictionary populated with dummy default data to assist integration forms. |
| GET | /api/v1/datasets /api/v1/runtime/ml/datasets |
X-API-Key | Lists registered datasets in the system database. |
| GET | /api/v1/datasets/{dataset_id} /api/v1/runtime/ml/datasets/{dataset_id} |
X-API-Key | Retrieves dataset file metadata, size, URL source, and summaries. |
| GET | /api/v1/datasets/{dataset_id}/schema /api/v1/runtime/ml/datasets/{dataset_id}/schema |
X-API-Key | Inspects dataset rows count, columns count, and target variable candidates. |
| GET | /api/v1/jobs /api/v1/runtime/ml/jobs |
X-API-Key | Lists all historical training jobs. |
| GET | /api/v1/jobs/{job_id} /api/v1/runtime/ml/jobs/{job_id} |
X-API-Key | Queries status, progress percentage, linked model, and errors for a training job. |
| GET | /api/v1/debug/system /api/v1/runtime/ml/debug/system |
X-API-Key | Developer diagnostics monitor. Summarizes DB status, models, datasets, jobs counts, and disk footprints. |