/v1/print-jobs/groups/split
Split group
Split a print-queue group into multiple smaller groups while preserving queue order. Bucket 0 keeps the original groupId; each subsequent bucket receives a fresh id.
Request Body
Group key and bucket sizes summing to the group size
Example Request
{
"groupKey": {
"groupId": "string"
},
"buckets": [
1
]
}
Response Schema
A URL to a recolored thumbnail that reflects any material customizations applied to the print job. Populated after material assignments are made, giving a more accurate preview of the expected output colors.
A URL to a thumbnail recolored to match the specific filament loaded in the assigned printer. Populated once the print job is assigned to a printer, and cleared if the job is unassigned.
A URL to the part's original thumbnail image, carried over from the part at the time the print job was created.
A URL to a recolored thumbnail that reflects any material customizations applied to the print job. Populated after material assignments are made, giving a more accurate preview of the expected output colors.
A URL to a thumbnail recolored to match the specific filament loaded in the assigned printer. Populated once the print job is assigned to a printer, and cleared if the job is unassigned.
A URL to the part's original thumbnail image, carried over from the part at the time the print job was created.
Example Response
{
"groups": [
{
"groupId": "string",
"jobs": [
{
"partBuildId": "string",
"quantityIndex": 1,
"quantityTotal": 1,
"thumbnailUri": "string",
"coloredThumbnailUri": "string",
"buildThumbnailUri": "string",
"cameraThumbnailUri": "string",
"timelapseUri": "string",
"fuseTelemetryUri": "string",
"attemptNumber": 1,
"sendFailureCount": 1,
"filesToPrint": [
"string"
],
"slicerInputHash": "string",
"isGcodeCached": true,
"slicedGcodeUri": "string",
"partId": "string",
"partName": "string",
"createdByActorId": "string",
"createdByType": "string",
"createdByLabel": "string",
"skuId": "string",
"skuName": "string",
"parameterOverrides": [
{
"name": "string",
"type": "number",
"value": 1
}
],
"orderId": "string",
"label": "string",
"orderItemId": "string",
"linkedPartId": "string",
"skuInstance": 1,
"queueOrder": 0,
"priority": 100,
"requiredPrinterTags": {
"printer.provider": "string",
"printer.id": "string",
"printer.nozzleDiameter": "string",
"printer.modelName": "string",
"filament.type": "string",
"user.tags": "string"
},
"overriddenProcessProfileId": "string",
"taskId": 1,
"profileUris": [
"string"
],
"assignedPrinterId": "string",
"assignmentStartedAt": "2025-01-15T12:00:00.000Z",
"assignmentCompletedAt": "2025-01-15T12:00:00.000Z",
"printingStartedAt": "2025-01-15T12:00:00.000Z",
"printingCompletedAt": "2025-01-15T12:00:00.000Z",
"cancelledAt": "2025-01-15T12:00:00.000Z",
"status": "pending",
"errorMessage": "string",
"hidden": true,
"logsUri": "string",
"extensions": {
"3mf": {
"plateId": 1,
"gcodeFile": "string"
},
"mergedPlate": {
"processOverrides": {},
"slicerVersionId": "string",
"childJobIds": [
"string"
],
"layout": [
{
"jobId": "string",
"x": 1,
"y": 1
}
],
"bedSize": {
"x": 1,
"y": 1,
"z": 1
},
"footprints": {},
"filamentColours": [
"string"
]
},
"serials": [
{
"sequenceId": "string",
"sequenceName": "string",
"parameterName": "string",
"value": 1,
"serial": "string",
"target": {
"plateId": 1,
"objectId": "string",
"instanceId": 1,
"identifyId": "string"
}
}
]
},
"skipObjectsData": {
"objects": [
{
"identifyId": "string",
"name": "string",
"skipped": true
}
],
"topImageUri": "string",
"pickImageUri": "string",
"runtimeSkips": [
{
"identifyId": "string",
"layer": 1,
"at": "string"
}
],
"excludedUsage": {
"objectIds": [
"string"
],
"bySlot": {},
"gramsBySlot": {},
"totalMm": 1,
"totalGrams": 1
}
},
"skipObjectIds": [
"string"
],
"materialMapping": [
{
"slot": 1,
"amsIndex": 1,
"slotIndex": 1,
"skip": true,
"variantId": "string",
"materialId": "string",
"materialType": "string",
"name": "string",
"color": "string",
"filamentUserProfileId": "string",
"filamentSystemProfileId": 1
}
],
"materialAssignments": {},
"gcodeAnalysisSha256": "string",
"groupId": "string",
"parentJobId": "string",
"boundingBox": {
"x": 1,
"y": 1,
"z": 1
},
"customMetadata": {},
"id": "string",
"storeId": "string",
"createdAt": "2025-01-15T12:00:00.000Z",
"updatedAt": "2025-01-15T12:00:00.000Z"
}
]
}
],
"affectedJobs": [
{
"partBuildId": "string",
"quantityIndex": 1,
"quantityTotal": 1,
"thumbnailUri": "string",
"coloredThumbnailUri": "string",
"buildThumbnailUri": "string",
"cameraThumbnailUri": "string",
"timelapseUri": "string",
"fuseTelemetryUri": "string",
"attemptNumber": 1,
"sendFailureCount": 1,
"filesToPrint": [
"string"
],
"slicerInputHash": "string",
"isGcodeCached": true,
"slicedGcodeUri": "string",
"partId": "string",
"partName": "string",
"createdByActorId": "string",
"createdByType": "string",
"createdByLabel": "string",
"skuId": "string",
"skuName": "string",
"parameterOverrides": [
{
"name": "string",
"type": "number",
"value": 1
}
],
"orderId": "string",
"label": "string",
"orderItemId": "string",
"linkedPartId": "string",
"skuInstance": 1,
"queueOrder": 0,
"priority": 100,
"requiredPrinterTags": {
"printer.provider": "string",
"printer.id": "string",
"printer.nozzleDiameter": "string",
"printer.modelName": "string",
"filament.type": "string",
"user.tags": "string"
},
"overriddenProcessProfileId": "string",
"taskId": 1,
"profileUris": [
"string"
],
"assignedPrinterId": "string",
"assignmentStartedAt": "2025-01-15T12:00:00.000Z",
"assignmentCompletedAt": "2025-01-15T12:00:00.000Z",
"printingStartedAt": "2025-01-15T12:00:00.000Z",
"printingCompletedAt": "2025-01-15T12:00:00.000Z",
"cancelledAt": "2025-01-15T12:00:00.000Z",
"status": "pending",
"errorMessage": "string",
"hidden": true,
"logsUri": "string",
"extensions": {
"3mf": {
"plateId": 1,
"gcodeFile": "string"
},
"mergedPlate": {
"processOverrides": {},
"slicerVersionId": "string",
"childJobIds": [
"string"
],
"layout": [
{
"jobId": "string",
"x": 1,
"y": 1,
"rotationDeg": 0
}
],
"bedSize": {
"x": 1,
"y": 1,
"z": 1
},
"footprints": {},
"filamentColours": [
"string"
]
},
"serials": [
{
"sequenceId": "string",
"sequenceName": "string",
"parameterName": "string",
"value": 1,
"serial": "string",
"target": {
"plateId": 1,
"objectId": "string",
"instanceId": 1,
"identifyId": "string"
}
}
]
},
"skipObjectsData": {
"objects": [
{
"identifyId": "string",
"name": "string",
"skipped": true
}
],
"topImageUri": "string",
"pickImageUri": "string",
"runtimeSkips": [
{
"identifyId": "string",
"layer": 1,
"at": "string"
}
],
"excludedUsage": {
"objectIds": [
"string"
],
"bySlot": {},
"gramsBySlot": {},
"totalMm": 1,
"totalGrams": 1
}
},
"skipObjectIds": [
"string"
],
"materialMapping": [
{
"slot": 1,
"amsIndex": 1,
"slotIndex": 1,
"skip": true,
"variantId": "string",
"materialId": "string",
"materialType": "string",
"name": "string",
"color": "string",
"filamentUserProfileId": "string",
"filamentSystemProfileId": 1
}
],
"materialAssignments": {},
"gcodeAnalysisSha256": "string",
"groupId": "string",
"parentJobId": "string",
"boundingBox": {
"x": 1,
"y": 1,
"z": 1
},
"customMetadata": {},
"id": "string",
"storeId": "string",
"createdAt": "2025-01-15T12:00:00.000Z",
"updatedAt": "2025-01-15T12:00:00.000Z"
}
]
}