Skip to main content
POST
Push a model to Hugging Face

Authorizations

Authorization
string
header
required

API key with the vk_ prefix. Create one from the dashboard.

Path Parameters

model_id
string
required

Model ID from the model library

Body

application/json
repo
string
required

Target repo as "namespace/name". Created on first push (honoring private); re-exports to an existing repo upload over it.

private
boolean

Repo visibility. Defaults to private — a public push is an explicit choice, never an accident.

Response

Export started; poll GET /v1/hf_exports/{id} for progress

object
string
required
id
string
required
model_id
string
required
repo
string
required
private
boolean
required
status
string
required

launching | uploading | completed | failed | cancelled

created_at
string<date-time>
required
progress_bytes
integer<int64> | null
total_bytes
integer<int64> | null
hf_repo_url
string | null

Set on completion; the pushed repo's URL.

error
string | null
completed_at
string<date-time> | null