API Endpoint Reference / Print Jobs

Retry a failed creation request from its stored input

POST https://api.printhiv3d.com/v1/print-jobs/create-requests/{requestId}/retry

Operation ID retryPrintJobCreateRequest. Requires the control API key scope.

Makes one new request with the next attempt, in the same batch, from the input Hive stored. Another call for the same failed request returns that request. A failed request that a send replaced, or one in a cancelled or archived batch, is refused with 409.

Parameters

NameInTypeRequiredDescription
requestIdpathstringYes

Responses

StatusDescription
202Default Response
400Invalid request or organization scope
401Authentication required
403Insufficient API key scope or organization membership
404Creation request not found
500Unexpected server error
503Creation request storage unavailable

202 response fields

FieldTypeRequiredDescription
requestIduuidYes
status"preparing" | "held" | "created" | "failed" | "cancelled"Yes
externalIdstring | nullYes
createdAtstringYes
plateinteger | nullNo
printerIduuid | nullNo
namestring | nullNo
sourceVersionIduuid | nullNo
jobobject | nullYes
requiredActionsobject[]Yes
warningsobject[]No
errorobject | nullYes
batchIduuid | nullNo
attemptintegerNo
retryOfuuid | nullNo
retriedByuuid | nullNo
supersededbooleanNo
variantsobject[]No
filamentsobject[]No
estimatedSecondsinteger | nullNo
createdJobIdinteger | nullNo
modelFileIduuid | nullNo

400 response fields

FieldTypeRequiredDescription
errorstringNo
messagestringNo
requestIdstringNo
codestringNo
statusCodeintegerNo

401 response fields

FieldTypeRequiredDescription
errorstringNo
messagestringNo
requestIdstringNo
codestringNo
statusCodeintegerNo

403 response fields

FieldTypeRequiredDescription
errorstringNo
messagestringNo
requestIdstringNo
codestringNo
statusCodeintegerNo

404 response fields

FieldTypeRequiredDescription
errorstringYes
messagestringNo
requestIdstringNo

500 response fields

FieldTypeRequiredDescription
errorstringNo
messagestringNo
requestIdstringNo
codestringNo
statusCodeintegerNo

503 response fields

FieldTypeRequiredDescription
errorstringNo
messagestringNo
requestIdstringNo
codestringNo
statusCodeintegerNo

Example 202 response

{
  "requestId": "a91d4f7c-3e2b-4a6d-8c5f-0b7e2d9a4c18",
  "status": "preparing",
  "externalId": "order-1042-line-1",
  "createdAt": "2026-11-04T18:00:00.000Z",
  "job": null,
  "requiredActions": [],
  "error": null,
  "plate": 1,
  "printerId": "7d3f1c2a-5b8e-4f6a-9c1d-2e4b6a8c0f13",
  "name": "Phone stand",
  "sourceVersionId": "5f8a2c6e-9d1b-4e73-b4a0-2c7e9f1d6b85",
  "warnings": [],
  "batchId": null,
  "attempt": 2,
  "retryOf": "a91d4f7c-3e2b-4a6d-8c5f-0b7e2d9a4c18",
  "retriedBy": null,
  "superseded": false
}