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
| Name | In | Type | Required | Description |
|---|
requestId | path | string | Yes | |
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 |
500 | Unexpected server error |
503 | Creation request storage unavailable |
202 response fields
| Field | Type | Required | Description |
|---|
requestId | uuid | Yes | |
status | "preparing" | "held" | "created" | "failed" | "cancelled" | Yes | |
externalId | string | null | Yes | |
createdAt | string | Yes | |
plate | integer | null | No | |
printerId | uuid | null | No | |
name | string | null | No | |
sourceVersionId | uuid | null | No | |
job | object | null | Yes | |
requiredActions | object[] | Yes | |
warnings | object[] | No | |
error | object | null | Yes | |
batchId | uuid | null | No | |
attempt | integer | No | |
retryOf | uuid | null | No | |
retriedBy | uuid | null | No | |
superseded | boolean | No | |
variants | object[] | No | |
filaments | object[] | No | |
estimatedSeconds | integer | null | No | |
createdJobId | integer | null | No | |
modelFileId | uuid | null | No | |
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 | |
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
{
"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
}