Sign in
Images

Get a image artifact

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

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/{version}
  • Auth: none declared

Path parameters

tenantstring required
namestring required
versionstring required

Response

Image detail.

createdAtstring date-time required

Time the version was created.

descriptionstring

Free-text version description.

digeststring

Content digest of the image.

displayNamestring

Human-readable version label.

idstring uuid required

Stable image version identifier.

namestring required

Image definition name (unique within the tenant).

namespacestring required

Platform tenant namespace the image belongs to.

ownerstring

Username of the version owner.

ownerIdstring uuid

User ID of the version owner.

readyAtstring date-time nullable

Time the version became Ready.

sizeBytesinteger

Total size of the image content in bytes.

source'webUpload' | 'oras' | 'dockerPush' | 'external'

How an artifact version was added.

specImageSpec

Artifact-side spec for kind=image; pass-through to artifacts.

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

Mirrors artifacts ArtifactStatus for kind=image.

tenantNamestring required

Tenant identifier owning the image.

updatedAtstring date-time

Time the version was last updated.

uristring

Artifact registry URI of the version.

versionstring required

Image version (tag).

Example response

{
  "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"
}

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