API Endpoint Reference / Partner production

Upload an immutable partner source

POST https://api.printhiv3d.com/v1/partner-production/uploads

Operation ID uploadPartnerSource. Requires the production:upload API key scope.

Stream the raw .3mf body with Content-Length. The source exists once its bytes are stored. Optional externalId binds the source to the organization's model for that partner design id.

Parameters

NameInTypeRequiredDescription
filenamequerystringNo
modelIdqueryuuidNo
externalIdquerystringNo
idempotency-keyheaderstringNo

Responses

StatusDescription
200Default Response
202Default Response
400Default Response
401Default Response
403Default Response
404Default Response
408Default Response
409Default Response
411Default Response
413Default Response
415Default Response
429Default Response
503Default Response

200 response fields

Send one of these shapes.

Option 1

FieldTypeRequiredDescription
sourceVersionIduuidYes
modelIduuidYes
externalIdstring | nullYes
sha256stringYes
filenamestringYes
bytesintegerYes
createdAtdate-timeYes
status"queued"Yes

Option 2

FieldTypeRequiredDescription
sourceVersionIduuidYes
modelIduuidYes
externalIdstring | nullYes
sha256stringYes
filenamestringYes
bytesintegerYes
createdAtdate-timeYes
status"inspecting"Yes

Option 3

FieldTypeRequiredDescription
sourceVersionIduuidYes
modelIduuidYes
externalIdstring | nullYes
sha256stringYes
filenamestringYes
bytesintegerYes
createdAtdate-timeYes
status"ready"Yes
inspectionobjectYes

Option 4

FieldTypeRequiredDescription
sourceVersionIduuidYes
modelIduuidYes
externalIdstring | nullYes
sha256stringYes
filenamestringYes
bytesintegerYes
createdAtdate-timeYes
status"failed"Yes
inspectionobject | nullYes
errorobjectYes

202 response fields

Send one of these shapes.

Option 1

FieldTypeRequiredDescription
sourceVersionIduuidYes
modelIduuidYes
externalIdstring | nullYes
sha256stringYes
filenamestringYes
bytesintegerYes
createdAtdate-timeYes
status"queued"Yes

Option 2

FieldTypeRequiredDescription
sourceVersionIduuidYes
modelIduuidYes
externalIdstring | nullYes
sha256stringYes
filenamestringYes
bytesintegerYes
createdAtdate-timeYes
status"inspecting"Yes

Option 3

FieldTypeRequiredDescription
sourceVersionIduuidYes
modelIduuidYes
externalIdstring | nullYes
sha256stringYes
filenamestringYes
bytesintegerYes
createdAtdate-timeYes
status"ready"Yes
inspectionobjectYes

Option 4

FieldTypeRequiredDescription
sourceVersionIduuidYes
modelIduuidYes
externalIdstring | nullYes
sha256stringYes
filenamestringYes
bytesintegerYes
createdAtdate-timeYes
status"failed"Yes
inspectionobject | nullYes
errorobjectYes

400 response fields

FieldTypeRequiredDescription
error"invalid_request" | "unauthorized" | "not_found" | "idempotency_conflict" | "external_id_conflict" | "content_length_required" | "upload_too_large" | "unsupported_media_type" | "upload_capacity_reached" | "upload_stalled" | "upload_disabled" | "storage_unavailable" | "storage_object_changed" | "database_unavailable" | "partner_source_unavailable"Yes
limitobjectNo

401 response fields

FieldTypeRequiredDescription
errorstringNo
messagestringNo
requestIdstringNo

403 response fields

FieldTypeRequiredDescription
errorstringNo
messagestringNo
requestIdstringNo

404 response fields

FieldTypeRequiredDescription
error"invalid_request" | "unauthorized" | "not_found" | "idempotency_conflict" | "external_id_conflict" | "content_length_required" | "upload_too_large" | "unsupported_media_type" | "upload_capacity_reached" | "upload_stalled" | "upload_disabled" | "storage_unavailable" | "storage_object_changed" | "database_unavailable" | "partner_source_unavailable"Yes
limitobjectNo

408 response fields

FieldTypeRequiredDescription
error"invalid_request" | "unauthorized" | "not_found" | "idempotency_conflict" | "external_id_conflict" | "content_length_required" | "upload_too_large" | "unsupported_media_type" | "upload_capacity_reached" | "upload_stalled" | "upload_disabled" | "storage_unavailable" | "storage_object_changed" | "database_unavailable" | "partner_source_unavailable"Yes
limitobjectNo

409 response fields

FieldTypeRequiredDescription
error"invalid_request" | "unauthorized" | "not_found" | "idempotency_conflict" | "external_id_conflict" | "content_length_required" | "upload_too_large" | "unsupported_media_type" | "upload_capacity_reached" | "upload_stalled" | "upload_disabled" | "storage_unavailable" | "storage_object_changed" | "database_unavailable" | "partner_source_unavailable"Yes
limitobjectNo

411 response fields

FieldTypeRequiredDescription
error"invalid_request" | "unauthorized" | "not_found" | "idempotency_conflict" | "external_id_conflict" | "content_length_required" | "upload_too_large" | "unsupported_media_type" | "upload_capacity_reached" | "upload_stalled" | "upload_disabled" | "storage_unavailable" | "storage_object_changed" | "database_unavailable" | "partner_source_unavailable"Yes
limitobjectNo

413 response fields

FieldTypeRequiredDescription
error"invalid_request" | "unauthorized" | "not_found" | "idempotency_conflict" | "external_id_conflict" | "content_length_required" | "upload_too_large" | "unsupported_media_type" | "upload_capacity_reached" | "upload_stalled" | "upload_disabled" | "storage_unavailable" | "storage_object_changed" | "database_unavailable" | "partner_source_unavailable"Yes
limitobjectNo

415 response fields

FieldTypeRequiredDescription
error"invalid_request" | "unauthorized" | "not_found" | "idempotency_conflict" | "external_id_conflict" | "content_length_required" | "upload_too_large" | "unsupported_media_type" | "upload_capacity_reached" | "upload_stalled" | "upload_disabled" | "storage_unavailable" | "storage_object_changed" | "database_unavailable" | "partner_source_unavailable"Yes
limitobjectNo

429 response fields

FieldTypeRequiredDescription
error"invalid_request" | "unauthorized" | "not_found" | "idempotency_conflict" | "external_id_conflict" | "content_length_required" | "upload_too_large" | "unsupported_media_type" | "upload_capacity_reached" | "upload_stalled" | "upload_disabled" | "storage_unavailable" | "storage_object_changed" | "database_unavailable" | "partner_source_unavailable"Yes
limitobjectNo

503 response fields

FieldTypeRequiredDescription
error"invalid_request" | "unauthorized" | "not_found" | "idempotency_conflict" | "external_id_conflict" | "content_length_required" | "upload_too_large" | "unsupported_media_type" | "upload_capacity_reached" | "upload_stalled" | "upload_disabled" | "storage_unavailable" | "storage_object_changed" | "database_unavailable" | "partner_source_unavailable"Yes
limitobjectNo

Example 202 response

{
  "sourceVersionId": "5f8a2c6e-9d1b-4e73-b4a0-2c7e9f1d6b85",
  "modelId": "c4a1e8f2-6d3b-4b97-a0e5-58f1d2c9b7a4",
  "externalId": "storefront-product-1042",
  "sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
  "filename": "phone-stand.3mf",
  "bytes": 2483621,
  "createdAt": "2026-11-04T18:00:00.000Z",
  "status": "queued"
}