Skip to main content

Get AI model upload status

GET 
/api/v1/orgs/{orgId}/ai-models/{modelId}/editions/{edition}/uploads/{uploadId}/status

Polls the status of an upload session, used by the client to track progress after registering and transferring a file.

  • uploadExpiresAt is returned only while the upload is still in progress (Pending or Uploading); it is omitted once the session reaches a terminal state. It marks when a stalled in-progress transfer may be restarted from scratch with the same uploadId. The uploadId itself never expires.

  • Clients typically poll this endpoint until the status becomes Uploaded (success) or a *Failed state (UploadFailed / VerifyFailed). Deploy the edition only after the status is Uploaded.

  • Returns 404 (UploadNotFound) if no upload matches the given orgId/modelId/edition/uploadId.

Request​

Responses​

Current upload status and expiry time (expiry only present while status is Pending or Uploading). Status values:

  • Pending: upload registered; TUS transfer not yet started.
  • Uploading: file transfer is in progress.
  • Verifying: transfer complete; server is computing SHA-256 for integrity verification.
  • Uploaded: hash verified successfully; edition is ready for deployment.
  • UploadFailed: upload was cancelled or the transfer stream failed.
  • VerifyFailed: hash mismatch or I/O error during verification.