Training Runs

Page Outline

• Path Parameters
• Query Parameters
• Behavior
• Response

---

Returns a list of all training runs associated with a model, including run metadata, status, duration, and the version produced (if successful).

Base Path: /api/v1/models

Method: GET

Path: /{model_id}/registry/training-runs

Auth: Requires a valid Bearer token (Authorization: Bearer <JWT>)

Path Parameters

Parameter	Type	Description
model_id	string	Unique identifier of the model

Query Parameters

Parameter	Type	Default	Description
status	string	—	Filter by run status: queued, running, completed, failed, cancelled
page	integer	1	Page number
page_size	integer	20	Results per page (max: 100)
sort_by	string	created_at	Sort field: created_at, duration_seconds
sort_order	string	desc	Sort direction: asc or desc

Behavior

• Includes all runs regardless of whether they produced a version (failed runs are included).
• Each run record links to its resulting version_id if the run completed successfully.
• Returns HTTP 404 if the model is not found.

Response

Returns a paginated TrainingRunList object.

{
  "total": 5,
  "page": 1,
  "page_size": 20,
  "results": [
    {
      "run_id": "run-20260313-a4b9c2",
      "status": "completed",
      "run_label": "experiment-lightgbm-v1",
      "version_produced": "ver-001",
      "duration_seconds": 312,
      "created_at": "2026-03-13T16:10:00Z",
      "completed_at": "2026-03-13T16:15:12Z",
      "created_by": "user-001"
    }
  ]
}