v4

latestOpenAPI 3.1.0MIT2026-08-04193459793.6 KB

VolumeService

Create a remote model upload

Starts an asynchronous job that imports model files from Hugging Face or a presigned URL into a registered model and creates a model revision when the import completes.

post/projects/{projectId}/models/uploads

Path parameters

projectIdstring required

Project identifier.

Request body

modelIdstring required

ID of the registered model that will receive the imported files.

remoteUrlstring required

Hugging Face repository URL or presigned archive URL to import.

tokenstring

Optional source credential used to access a private remote location. The value is write-only and is not returned.

Response

idstring required

Unique ID of the remote model import job.

projectIdstring required

ID of the project that owns the import job.

modelIdstring required

ID of the registered model receiving the imported files.

remoteUrlstring required

Hugging Face repository or presigned URL being imported.

status'REMOTE_UPLOAD_STATUS_PENDING' | 'REMOTE_UPLOAD_STATUS_RUNNING' | 'REMOTE_UPLOAD_STATUS_ERROR' | 'REMOTE_UPLOAD_STATUS_SUCCEEDED' | 'REMOTE_UPLOAD_STATUS_FAILED' required

Current lifecycle state of the asynchronous import job.

statusMessagestring

Human-readable progress or failure detail for the current status.

restartCountinteger

Number of times the import worker has restarted this job.

maxRestartsinteger

Maximum worker restarts allowed before the job fails permanently.

createdAtstring date-time required

Time when the import job was created.

updatedAtstring date-time

Time when the import job was last updated.