API Endpoint Reference / Print Jobs

Approve the reported holds of a creation request and re-slice

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

Operation ID approvePrintJobCreateRequestReview. Requires the control API key scope.

Requires control scope. Read the request first: each hold in `requiredActions` lists its `allowedActions`, and approval succeeds only when every hold of the request lists `approve`. A request held for an engine setting review (`project_review_required` with `changes`) takes `{ changes, sourceRelease, engineRelease }` copied from the hold. A request held for `inspection_review_required` with reason `material_usage_unresolved` takes `{ inspection: { plateVersion } }` with the `plateVersion` that the hold reported. A request held for both takes both. Other inspection reasons, and every other hold code on any held plate, allow cancel only. A request with a `printer_id` has one plate. A request without one has a plate for each target configuration, and `plateVersion` covers every held plate: one approval applies to all of them. Approval of a changed plate returns 409: read the request again for its current holds and `plateVersion`.

Parameters

NameInTypeRequiredDescription
requestIdpathstringYes

Request body

Content type application/json.

Send one of these shapes.

Option 1

FieldTypeRequiredDescription
changesobject[]Yes
sourceReleasestring | nullYes
engineReleasestringYes

Option 2

FieldTypeRequiredDescription
inspectionobjectYes

Option 3

FieldTypeRequiredDescription
changesobject[]Yes
sourceReleasestring | nullYes
engineReleasestringYes
inspectionobjectYes

Responses

StatusDescription
202Default Response
400Invalid request or organization scope
401Authentication required
403Insufficient API key scope or organization membership, or an inspection approval from a principal that is neither an API key nor a signed-in user, so Hive has no actor to record (approval_actor_required)
404Creation request not found
409The approval does not match the held creation request: the plate changed, a hold does not allow approval, or the body names a review the plate does not hold (review_conflict)
500Unexpected server error
503Creation request storage unavailable

202 response fields

FieldTypeRequiredDescription
approvedbooleanYes

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

409 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

{
  "approved": true
}