Sign in
Images

List versions of a image definition (live)

Changed on
get/api/v1/images/{tenant}/{name}/versions

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/v1/images/{tenant}/{name}/versions
  • Auth: none declared

Path parameters

tenantstring required
namestring required

Query parameters

status'Uploading' | 'Ready' | 'Failed' | 'Deleting' | 'Deleted'

Mirrors artifacts ArtifactStatus for kind=image.

limitinteger

Page size (default 50, max 200).

continuestring

Opaque continue token from the previous response.

Response

A page of image versions.

continueTokenstring

Opaque token to fetch the next page.

countinteger required

Number of image versions in this page.

partialboolean

True if the list was truncated by an upstream limit.

Example response

{
  "continueToken": "",
  "count": 1,
  "items": [
    {
      "createdAt": "2026-06-20T08:00:00Z",
      "description": "Training image with PyTorch 2.3 and CUDA 12.",
      "digest": "sha256:7f3148e1f4a6c8e3d2b4a6c8e1f9b0d5a2c7f3148e1f4a6c8e3d2b4a6c8e1f9b",
      "displayName": "PyTorch Training 2.3.0",
      "id": "a1b2c3d4-5e6f-7081-92a3-b4c5d6e7f809",
      "name": "pytorch-train",
      "namespace": "team-vision",
      "owner": "li.wei",
      "ownerId": "3a2b1c0d-4e5f-6789-abcd-ef0123456789",
      "readyAt": "2026-06-28T09:30:00Z",
      "sizeBytes": 5368709120,
      "source": "dockerPush",
      "spec": {
        "baseImage": "nvidia/cuda:12.1.0-runtime",
        "purpose": "training",
        "python": "3.11"
      },
      "status": "Ready",
      "tenantName": "team-vision",
      "updatedAt": "2026-06-28T09:30:00Z",
      "uri": "oci://registry.axisml.io/team-vision/pytorch-train:2.3.0",
      "version": "2.3.0"
    }
  ],
  "partial": false
}

Changes

  • d51e2e0e6970Revision changes
    • breaking

      the // response's property type changed from string to no type for status

    • breaking

      the // response's property type changed from object to no type for status

    • breaking

      the // response's property type changed from string to no type for status

    • info

      added to the // response property allOf list for the response status

    • info

      added to the // response property allOf list for the response status

    • info

      added to the // response property allOf list for the response status

    • info

      removed the Deleted enum value from the // response property for the response status

    • info

      removed the Deleting enum value from the // response property for the response status

    • info

      removed the Failed enum value from the // response property for the response status

    • info

      removed the Ready enum value from the // response property for the response status

    • info

      removed the Uploading enum value from the // response property for the response status

    • info

      removed the dockerPush enum value from the // response property for the response status

    • info

      removed the external enum value from the // response property for the response status

    • info

      removed the oras enum value from the // response property for the response status

    • info

      removed the webUpload enum value from the // response property for the response status