Sign in
Models

Initiate a model version upload

Changed on
post/api/v1/models/{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/models/{tenant}/{name}/versions
  • Auth: none declared

Path parameters

tenantstring required
namestring required

Request body

descriptionstring

Free-text version description.

displayNamestring

Human-readable version label.

remoteSourceKind's3' | 'oci' | 'http' | 'hf' | 'custom'

Backing store of an externally-registered model version.

remoteUristring

Remote artifact URI to register (required when source=external).

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

How an artifact version was added.

specModelSpec

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

versionstring required

Model version label to create.

Example request

{
  "description": "ResNet-50 weights fine-tuned on ImageNet.",
  "displayName": "ResNet-50 v1.4.0",
  "source": "webUpload",
  "version": "1.4.0"
}

Response

Upload initiated; returns credentials and a model handle.

expiresAtstring date-time

Expiry time of the upload credentials.

idstring uuid required

Identifier of the newly initiated model version.

storageKind'oci' | 's3'

Backing store of the upload target (oci, s3).

uploadCredentialsobject

Short-lived credentials for pushing the content.

uristring required

Upload target URI for the version content.

Example response

{
  "expiresAt": "2026-06-28T09:30:00Z",
  "id": "c4a7f1e9-3d2b-4a6c-8e1f-9b0d5a2c7f31",
  "storageKind": "oci",
  "uploadCredentials": {
    "password": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9",
    "username": "upload-token"
  },
  "uri": "oci://registry.axisml.io/team-vision/resnet50:1.4.0"
}

Changes

  • d51e2e0e6970Revision changes
    • breaking

      added to the request property allOf list

    • breaking

      added to the request property allOf list

    • breaking

      added to the request property allOf list

    • breaking

      removed the enum value custom of the request property

    • breaking

      removed the enum value dockerPush of the request property

    • breaking

      removed the enum value external of the request property

    • breaking

      removed the enum value hf of the request property

    • breaking

      removed the enum value http of the request property

    • breaking

      removed the enum value oci of the request property

    • breaking

      removed the enum value oras of the request property

    • breaking

      removed the enum value s3 of the request property

    • breaking

      removed the enum value webUpload of the request property

    • breaking

      the request property type changed from string to no type

    • breaking

      the request property type changed from string to no type

    • breaking

      the request property type changed from object to no type