Skip to main content
POST
Create a remote model upload

Authorizations

Authorization
string
header
default:default
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

projectId
string
required

Project identifier.

Body

application/json

Request parameters for creating a remote upload.

modelId
string
required

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

remoteUrl
string
required

Hugging Face repository URL or presigned archive URL to import.

token
string

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

Response

OK

Asynchronous job that imports remote files into a registered model and creates a model revision.

id
string
required

Unique ID of the remote model import job.

projectId
string
required

ID of the project that owns the import job.

modelId
string
required

ID of the registered model receiving the imported files.

remoteUrl
string
required

Hugging Face repository or presigned URL being imported.

status
enum<string>
required

Current lifecycle state of the asynchronous import job.

Available options:
REMOTE_UPLOAD_STATUS_PENDING,
REMOTE_UPLOAD_STATUS_RUNNING,
REMOTE_UPLOAD_STATUS_ERROR,
REMOTE_UPLOAD_STATUS_SUCCEEDED,
REMOTE_UPLOAD_STATUS_FAILED
createdAt
string<date-time>
required

Time when the import job was created.

statusMessage
string

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

restartCount
integer

Number of times the import worker has restarted this job.

maxRestarts
integer

Maximum worker restarts allowed before the job fails permanently.

updatedAt
string<date-time>

Time when the import job was last updated.