List Model Versions

Page Outline

• Path Parameters
• Query Parameters
• Behavior
• Response

---

Returns all training-generated versions for a specific model, ordered from most recent to oldest.

Base Path: /api/v1/models

Method: GET

Path: /{model_id}/versions

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
page	integer	1	Page number
page_size	integer	20	Results per page (max: 100)
promoted_only	boolean	false	If true, returns only the promoted (production) version

Behavior

• Each successful training run produces a new version, incrementing the version number by 1.
• The currently promoted version is indicated by "is_promoted": true.
• Deleted or failed training runs do not create version records.
• Returns HTTP 404 if the model does not exist within the caller's organization.

Response

Returns a paginated VersionList object.

{
  "total": 3,
  "page": 1,
  "page_size": 20,
  "results": [
    {
      "version_id": "ver-001",
      "version_number": 3,
      "is_promoted": true,
      "metrics": { "accuracy": 0.934, "f1_score": 0.921 },
      "trained_at": "2026-03-13T14:22:10Z",
      "trained_by": "user-001"
    },
    {
      "version_id": "ver-002",
      "version_number": 2,
      "is_promoted": false,
      "metrics": { "accuracy": 0.911, "f1_score": 0.905 },
      "trained_at": "2026-03-12T10:00:00Z",
      "trained_by": "user-001"
    }
  ]
}