Printago API
PATCH /v1/materials/printer-slots/assign

Assign to printer slots

Assign materials to printer filament slots (AMS slots). With `instanceId`, the slot takes that roll's variant, material and color, and the roll's serial (or none, when the roll has none). A roll already loaded in another slot moves: that slot is cleared in the same transaction, so a roll is never in two slots. An `instanceId` request targets exactly one slot. Loading or moving a roll changes no weight.

Requires: printer.edit

Request Body

Printer IDs, visual slot positions, and material to assign

printerIdsCuid2visualSlotsVisualSlotsetOnPrinterbooleanundefinedmaterialTypestringfilamentUserProfileIdCuid2nullundefinedfilamentSystemProfileIdnumber...1more...undefinedvariantIdnullundefinedmaterialIdnullundefinedinstanceIdnullundefined... | printerIdsCuid2visualSlotsVisualSlotsetOnPrinterbooleanundefinedinstanceIdCuid2filamentUserProfileIdCuid2nullundefinedfilamentSystemProfileIdnumber...1more...undefinedvariantIdnullundefinedmaterialIdnullundefinedmaterialTypenullundefined | printerIdsCuid2visualSlotsVisualSlotsetOnPrinterbooleanundefinedvariantIdCuid2filamentUserProfileIdCuid2nullundefinedfilamentSystemProfileIdnumber...1more...undefinedinstanceIdnullundefinedmaterialIdnullundefinedmaterialTypenullundefined | printerIdsCuid2visualSlotsVisualSlotsetOnPrinterbooleanundefinedmaterialIdCuid2filamentUserProfileIdCuid2nullundefinedfilamentSystemProfileIdnumber...1more...undefinedinstanceIdnullundefinedvariantIdnullundefinedmaterialTypenullundefined
Variant 1printerIdsCuid2visualSlotsVisualSlotsetOnPrinterbooleanundefinedmaterialTypestringfilamentUserProfileIdCuid2nullundefinedfilamentSystemProfileIdnumber...1more...undefinedvariantIdnullundefinedmaterialIdnullundefinedinstanceIdnullundefined...
filamentSystemProfileIdoptionalnullable
number
filamentUserProfileIdoptionalnullable
string
pattern: ^[a-z0-9]{24}$
instanceIdoptional
null
materialIdoptional
null
materialTyperequired
string
printerIdsrequired
string[]
setOnPrinteroptional
boolean
variantIdoptional
null
visualSlotsrequired
object[]
amsIndexrequired
number
slotIndexrequired
number
Variant 2printerIdsCuid2visualSlotsVisualSlotsetOnPrinterbooleanundefinedinstanceIdCuid2filamentUserProfileIdCuid2nullundefinedfilamentSystemProfileIdnumber...1more...undefinedvariantIdnullundefinedmaterialIdnullundefinedmaterialTypenullundefined
filamentSystemProfileIdoptionalnullable
number
filamentUserProfileIdoptionalnullable
string
pattern: ^[a-z0-9]{24}$
instanceIdrequired
string
pattern: ^[a-z0-9]{24}$
materialIdoptional
null
materialTypeoptional
null
printerIdsrequired
string[]
setOnPrinteroptional
boolean
variantIdoptional
null
visualSlotsrequired
object[]
amsIndexrequired
number
slotIndexrequired
number
Variant 3printerIdsCuid2visualSlotsVisualSlotsetOnPrinterbooleanundefinedvariantIdCuid2filamentUserProfileIdCuid2nullundefinedfilamentSystemProfileIdnumber...1more...undefinedinstanceIdnullundefinedmaterialIdnullundefinedmaterialTypenullundefined
filamentSystemProfileIdoptionalnullable
number
filamentUserProfileIdoptionalnullable
string
pattern: ^[a-z0-9]{24}$
instanceIdoptional
null
materialIdoptional
null
materialTypeoptional
null
printerIdsrequired
string[]
setOnPrinteroptional
boolean
variantIdrequired
string
pattern: ^[a-z0-9]{24}$
visualSlotsrequired
object[]
amsIndexrequired
number
slotIndexrequired
number
Variant 4printerIdsCuid2visualSlotsVisualSlotsetOnPrinterbooleanundefinedmaterialIdCuid2filamentUserProfileIdCuid2nullundefinedfilamentSystemProfileIdnumber...1more...undefinedinstanceIdnullundefinedvariantIdnullundefinedmaterialTypenullundefined
filamentSystemProfileIdoptionalnullable
number
filamentUserProfileIdoptionalnullable
string
pattern: ^[a-z0-9]{24}$
instanceIdoptional
null
materialIdrequired
string
pattern: ^[a-z0-9]{24}$
materialTypeoptional
null
printerIdsrequired
string[]
setOnPrinteroptional
boolean
variantIdoptional
null
visualSlotsrequired
object[]
amsIndexrequired
number
slotIndexrequired
number

Example Request

application/json 
{
  "printerIds": [
    "string"
  ],
  "visualSlots": [
    {
      "amsIndex": 1,
      "slotIndex": 1
    }
  ],
  "setOnPrinter": true,
  "materialType": "string",
  "filamentUserProfileId": "string",
  "filamentSystemProfileId": 1
}