API Endpoint Reference / Print Jobs

Authorize admission of a manually held creation request

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

Operation ID releasePrintJobCreateRequest. Requires the control API key scope.

Requires control scope. Sends no body. Authorization does not approve other preparation holds. Poll the creation request for job admission.

Parameters

NameInTypeRequiredDescription
requestIdpathstringYesCreation request UUID. Invalid or inaccessible IDs return 404.

Responses

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

202 response fields

FieldTypeRequiredDescription
authorizedbooleanYes

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
error"manual_release_not_available"Yes
messagestringNo
requestIdstringNo

500 response fields

FieldTypeRequiredDescription
errorstringNo
messagestringNo
requestIdstringNo
codestringNo
statusCodeintegerNo

503 response fields

FieldTypeRequiredDescription
errorstringNo
messagestringNo
requestIdstringNo
codestringNo
statusCodeintegerNo

Example 202 response

{
  "authorized": true
}