Models

Create a model version async

POST /models/{name}/versions/{version}/createAsync

Creates a model version asynchronously with blob content validation. Returns 202 Accepted with a location header for polling the operation status.

Query parameters

api-version string required

The API version to use for this operation.

Header parameters

Foundry-Features enum required

A feature flag opt-in required when using preview operations or modifying persisted preview resources.

Models=V1Preview

Path parameters

name string required

Name of the model.

version string required

Version of the model.

Request Body

Model version to create.

Content-Type: application/json

blobUri string required

URI of the model artifact in blob storage

weightType string | enum

The weight type of the model.

Any of the following:

string

enum

FullWeightLoRADraftModel

baseModel string

Base model asset ID

source ModelSourceData

Source information for the model

sourceType string | enum

The source type of the model.

Any of the following:

string

enum

LocalUploadTrainingJob

jobId string

The job ID that produced this model

loraConfig LoraConfig

Adapter-specific metadata for LoRA models. Drives serving engine configuration at deployment time.

rank integer

LoRA rank (r). Positive integer. Common values: 8, 16, 32, 64.

alpha integer

LoRA scaling factor (α). Positive integer; typically 2× the rank.

targetModules string[]

Model layers modified by the adapter (e.g., q_proj, v_proj). Auto-detected from adapter_config.json if omitted.

dropout number

Dropout rate used during training. Informational — not used at serving time.

artifactProfile ArtifactProfile

Artifact profile of the model

category string | enum required

The artifact profile category.

Any of the following:

string

enum

DataOnlyRuntimeDependentUnknown

signals FoundryModelArtifactProfileSignal[]

Signals detected in the model artifact

warnings FoundryModelWarning[]

Service-computed advisory warnings derived from the artifact profile.

id string

Asset ID, a unique identifier for the asset

name string required

The name of the resource

version string required

The version of the resource

description string

The asset description text.

tags object

Tag dictionary. Tags can be added, removed, and updated.

[key: string] string

Responses

Accepted response for asynchronous model version creation, with polling location.

Headers

Location string

URL to poll for operation status.

Body

Content-Type: application/json

location string

URL to poll for operation status.

operationResult string | null

URL to the operation result, or null if the operation is still in progress.