Printago API
POST /v1/print-jobs/merge

Merge print jobs onto one plate

Merge two or more compatible pending jobs onto a single build plate. The server re-validates compatibility, recomputes the plate layout authoritatively, creates the merged (parent) job, links the children, and kicks asynchronous merged-3MF authoring.

Requires: queue.manage

Request Body

Job ids to merge and the target bed size

MergePlatesRequest
bedSizerequired
object
{x,y,z} mm build volume of the target plate.
xrequired
number
yrequired
number
zrequired
number
jobIdsrequired
string[]
min items: 2
partSpacingMmoptional
number
Per-merge override of the store's part spacing (mm) — some parts need more clearance than the store default. Absent = store setting.
min: 0max: 100
plateMarginMmoptional
number
Per-merge override of the store's plate edge margin (mm). Absent = store setting.
min: 0max: 100

Example Request

application/json 
{
  "jobIds": [
    "string"
  ],
  "bedSize": {
    "x": 1,
    "y": 1,
    "z": 1
  },
  "partSpacingMm": 0,
  "plateMarginMm": 0
}

Response Schema

MergePlatesResponse
layoutrequired
object[]
The authoritative placements the merged plate was committed with.
jobIdrequired
string
rotationDegrequired
any
xrequired
number
World-coordinate center of the placed footprint, mm.
yrequired
number
parentJobIdrequired
string
The newly created merged (parent) print job.
pattern: ^[a-z0-9]{24}$

Example Response

201 OK — application/json 
{
  "parentJobId": "string",
  "layout": [
    {
      "jobId": "string",
      "x": 1,
      "y": 1
    }
  ]
}