POST /v1/batch-jobs — hive-api-documentation

post/v1/batch-jobs

Request body

namestring required

descriptionstring

quantitynumber

model_file_idstring

organization_idstring required

organizationIdstring

printer_idsstring[]

task_idstring

make_idstring

Optional make ID to derive required materials

max_concurrent_printersinteger nullable

Maximum printers running jobs from this batch simultaneously

deadlinestring date-time

ISO 8601 deadline for production batch completion

dedicated_printer_idsstring[]

Optional dedicated printer pool for this batch

printer_configsobject

Default Response

Changed in 4 of the 24 revisions of this API.136

Aug 20, 20266fe5e0368cb011See the full diff
- ▲
  the max_concurrent_printers request property type/format changed from number/ to integer/
  request-property-type-changed
- ○
  the request property max_concurrent_printers became nullable
  request-property-became-nullable
Aug 11, 20266ac11cc265be4See the full diff
- ○
  added the new optional request property print_options/set_printer_ready
  new-optional-request-property
- ○
  added the new optional request property print_options/start_immediately
  new-optional-request-property
- ○
  added the new optional request property printer_configs/additionalProperties/print_options/set_printer_ready
  new-optional-request-property
- ○
  added the new optional request property printer_configs/additionalProperties/print_options/start_immediately
  new-optional-request-property
Aug 6, 20268be36ce70a6b3See the full diff
- ●
  removed the request property print_options/set_printer_ready
  request-property-removed
- ●
  removed the request property print_options/start_immediately
  request-property-removed
- ●
  removed the request property printer_configs/additionalProperties/print_options/set_printer_ready
  request-property-removed
Jul 26, 2026750c8a1363071See the full diff
- ○
  added the non-success response with the status 409
  response-non-success-status-added