---
title: "Upload an immutable partner source"
method: POST
path: "/v1/partner-production/uploads"
tags: ["Partner production"]
---

# Upload an immutable partner source

`POST /v1/partner-production/uploads`

## Request

- Base URL: `https://api.printhiv3d.com`
- URL: `https://api.printhiv3d.com/v1/partner-production/uploads`
- Auth: API key in header `x-api-key`

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.

## Query parameters

- `filename` string
- `modelId` string, uuid
- `externalId` string

## Headers

- `idempotency-key` string

## Response `200`

Default Response

- union
  - object
    - `sourceVersionId` string, uuid, required
    - `modelId` string, uuid, required
    - `externalId` string, nullable, required
    - `sha256` string, required
    - `filename` string, required
    - `bytes` integer, required
    - `createdAt` string, date-time, required
    - `status` 'queued', required
  - object
    - `sourceVersionId` string, uuid, required
    - `modelId` string, uuid, required
    - `externalId` string, nullable, required
    - `sha256` string, required
    - `filename` string, required
    - `bytes` integer, required
    - `createdAt` string, date-time, required
    - `status` 'inspecting', required
  - object
    - `sourceVersionId` string, uuid, required
    - `modelId` string, uuid, required
    - `externalId` string, nullable, required
    - `sha256` string, required
    - `filename` string, required
    - `bytes` integer, required
    - `createdAt` string, date-time, required
    - `status` 'ready', required
    - `inspection` object, required
      - `version` 1, required
      - `classification` 'project' | 'geometry_only' | 'toolpath_only', required
      - `hasEmbeddedGcode` boolean, required
      - `plates` object[], required
        - `number` integer, required
        - `objectIds` string[], required
      - `objects` object[], required
        - `id` string, required
        - `entry` string, required
        - `objectId` integer, required
        - `name` string, nullable, required
        - `kind` 'mesh' | 'assembly' | 'support' | 'other', required
        - `materialSlots` integer[], required
      - `materialSlots` object[], required
        - `slot` integer, required
        - `material` string, nullable, required
        - `color` string, nullable, required
        - `profile` string, nullable, required
      - `materialUsage` 'complete' | 'requires_review', required
      - `reviewReasons` string[], required
      - `authoringEngine` union
        - object
          - `status` 'recognized', required
          - `family` 'bambu_studio' | 'orca_slicer', required
          - `release` string, required
          - `releaseLine` string, required
          - `major` integer, required
          - `evidence` string[], required
        - object
          - `status` 'unsupported_family', required
          - `application` string, required
        - object
          - `status` 'fork', required
          - `application` string, required
          - `release` string, required
        - object
          - `status` 'disagreeing', required
          - `values` object, required
            - `application` string
            - `projectSettingsVersion` string
            - `sliceInfoClientVersion` string
        - object
          - `status` 'unparseable', required
          - `values` object, required
            - `application` string
            - `projectSettingsVersion` string
            - `sliceInfoClientVersion` string
        - object
          - `status` 'missing', required
      - `printerModel` string
  - object
    - `sourceVersionId` string, uuid, required
    - `modelId` string, uuid, required
    - `externalId` string, nullable, required
    - `sha256` string, required
    - `filename` string, required
    - `bytes` integer, required
    - `createdAt` string, date-time, required
    - `status` 'failed', required
    - `inspection` object, nullable, required
      - `version` 1, required
      - `classification` 'project' | 'geometry_only' | 'toolpath_only', required
      - `hasEmbeddedGcode` boolean, required
      - `plates` object[], required
        - `number` integer, required
        - `objectIds` string[], required
      - `objects` object[], required
        - `id` string, required
        - `entry` string, required
        - `objectId` integer, required
        - `name` string, nullable, required
        - `kind` 'mesh' | 'assembly' | 'support' | 'other', required
        - `materialSlots` integer[], required
      - `materialSlots` object[], required
        - `slot` integer, required
        - `material` string, nullable, required
        - `color` string, nullable, required
        - `profile` string, nullable, required
      - `materialUsage` 'complete' | 'requires_review', required
      - `reviewReasons` string[], required
      - `authoringEngine` union
        - object
          - `status` 'recognized', required
          - `family` 'bambu_studio' | 'orca_slicer', required
          - `release` string, required
          - `releaseLine` string, required
          - `major` integer, required
          - `evidence` string[], required
        - object
          - `status` 'unsupported_family', required
          - `application` string, required
        - object
          - `status` 'fork', required
          - `application` string, required
          - `release` string, required
        - object
          - `status` 'disagreeing', required
          - `values` object, required
            - `application` string
            - `projectSettingsVersion` string
            - `sliceInfoClientVersion` string
        - object
          - `status` 'unparseable', required
          - `values` object, required
            - `application` string
            - `projectSettingsVersion` string
            - `sliceInfoClientVersion` string
        - object
          - `status` 'missing', required
      - `printerModel` string
    - `error` object, required
      - `code` 'invalid_archive' | 'unsafe_path' | 'unsafe_xml' | 'resource_limit' | 'invalid_project' | 'toolpath_only' | 'processing_timeout' | 'storage_object_changed' | 'inspection_interrupted' | 'upload_interrupted', required
      - `message` string, required
      - `limit` object
        - `name` 'uploadBytes' | 'concurrentUploads' | 'concurrentUploadsPerOrganization' | 'uploadIdleTimeoutMs' | 'uploadTimeoutMs' | 'entries' | 'compressionRatio' | 'modelPartExpandedBytes' | 'expandedBytes' | 'parserBytesPerDocument' | 'parserBytesPerArchive' | 'xmlDepth' | 'xmlElementsPerDocument' | 'objects' | 'plates' | 'materialSlots' | 'inspectionTimeoutMs' | 'inspectorHeapMb', required
        - `max` number, required
        - `observed` number

## Other responses

- `202`: Default Response
- `400`: Default Response
- `401`: Default Response
- `403`: Default Response
- `404`: Default Response
- `408`: Default Response
- `409`: Default Response
- `411`: Default Response
- `413`: Default Response
- `415`: Default Response
- `429`: Default Response
- `503`: Default Response

## Changes

- **2026-10-31** `782c0bee2cd4`: 4 info
  - added `subschema #3, subschema #4` to the response body `anyOf` list for the response status `200`
  - added `subschema #3, subschema #4` to the response body `anyOf` list for the response status `202`
  - removed `subschema #3, subschema #4` from the response body `anyOf` list for the response status `200`
  - removed `subschema #3, subschema #4` from the response body `anyOf` list for the response status `202`
- **2026-10-30** `f4d2cdd1c9f2`: 4 info
  - added `subschema #3, subschema #4` to the response body `anyOf` list for the response status `200`
  - added `subschema #3, subschema #4` to the response body `anyOf` list for the response status `202`
  - removed `subschema #3, subschema #4` from the response body `anyOf` list for the response status `200`
  - removed `subschema #3, subschema #4` from the response body `anyOf` list for the response status `202`
- …earlier changes not shown

[Operation history](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/changes/v1/partner-production/uploads/post.md)

---

[API](https://skmtc.dev/printhiv3d/apis/hive-api-documentation.md) - [All operations](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/revisions/906fa9f15f12?raw)