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
| Name | In | Type | Required | Description |
|---|
requestId | path | string | Yes | Creation request UUID. Invalid or inaccessible IDs return 404. |
Responses
| Status | Description |
|---|
202 | Default Response |
400 | Invalid request or organization scope |
401 | Authentication required |
403 | Insufficient API key scope or organization membership |
404 | Creation request not found |
409 | Manual release is unavailable or another hold remains |
500 | Unexpected server error |
503 | Creation request storage unavailable |
202 response fields
| Field | Type | Required | Description |
|---|
authorized | boolean | Yes | |
400 response fields
| Field | Type | Required | Description |
|---|
error | string | No | |
message | string | No | |
requestId | string | No | |
code | string | No | |
statusCode | integer | No | |
401 response fields
| Field | Type | Required | Description |
|---|
error | string | No | |
message | string | No | |
requestId | string | No | |
code | string | No | |
statusCode | integer | No | |
403 response fields
| Field | Type | Required | Description |
|---|
error | string | No | |
message | string | No | |
requestId | string | No | |
code | string | No | |
statusCode | integer | No | |
404 response fields
| Field | Type | Required | Description |
|---|
error | string | Yes | |
message | string | No | |
requestId | string | No | |
409 response fields
| Field | Type | Required | Description |
|---|
error | "manual_release_not_available" | Yes | |
message | string | No | |
requestId | string | No | |
500 response fields
| Field | Type | Required | Description |
|---|
error | string | No | |
message | string | No | |
requestId | string | No | |
code | string | No | |
statusCode | integer | No | |
503 response fields
| Field | Type | Required | Description |
|---|
error | string | No | |
message | string | No | |
requestId | string | No | |
code | string | No | |
statusCode | integer | No | |
Example 202 response
{
"authorized": true
}