List scan actions

GET /v1/qr-tags/actions

Every action a scan can offer, the way the QR Workflows settings page lists them: its `subject` is the tag type (`printer`, `printer_slot`, `material_variant`, `material_instance`) or the pair key (the two types sorted and joined with `+`, such as `blank+material_variant`) that offers it, `permission` is what running it needs, and `default` marks the action that is the main button when nothing else wins it. Actions come in catalog order, the order a scan lists them in until the store sets its own. Use the ids in the store's `qrWorkflowSettings`.

Requires: qr.manage

Response Schema

QrCatalogAction[]

Array of QrCatalogAction, each with:

defaultrequired

boolean

The main button when nothing else wins it, such as Open printer for an idle printer

descriptionrequired

string

destructiverequired

boolean

entitlementrequirednullable

string

Offered only with this add-on; null when every store has it

idrequired

enum

printer.confirmReadyprinter.openprinter.unreadyprinter.pauseprinter.resumeprinter.stopprinter.homeprinter.runQueueprinter.enableprinter.disableprinter.sendJobprinter.runMacroprinter.maintenanceDoneprinter.unloadFilamentprinter.clearAllSlotsslot.assignslot.loadslot.clearslot.refreshRfidslot.openPrintervariant.assignvariant.registerSpoolspool.updateGramsspool.removespool.loadspool.markEmptyspool.openPrinterpair.assignVariantToPrinterpair.assignVariantToSlotpair.moveSlotpair.swapSlotspair.loadSpoolIntoPrinterpair.loadSpoolIntoSlotpair.bindBlankAsNewSpoolpair.bindBlankToVariantpair.bindBlankToPrinterpair.bindBlankToSlotpair.bindBlankToSpool

kindrequired

"webhook" | "builtin"

webhookbuiltin

labelrequired

string

permissionrequired

enum

organization.ownerorganization.editorganization.deleteuser.viewuser.inviteuser.edituser.deletepermission.viewpermission.grantpermission.revokepart.viewpart.createpart.editpart.deletepart.exportsku.viewsku.createsku.editsku.deletematerial.viewmaterial.creatematerial.editmaterial.deletematerial.instance.viewmaterial.instance.creatematerial.instance.editmaterial.instance.deleteprinter.viewprinter.createprinter.editprinter.deleteprinter.controlprinter.readyprinter.configprinter.statsprinter.cameraprofile.viewprofile.createprofile.editprofile.deletequeue.viewqueue.managequeue.overridejob.createjob.edit.ownjob.edit.alljob.delete.ownjob.delete.allbuild.viewbuild.createbuild.editbuild.deletesettings.viewsettings.editintegration.viewintegration.managesubscription.viewsubscription.manageanalytics.viewreports.generateaudit.log.viewaudit.logs.configureorder.vieworder.createorder.editorder.deleteorder.printapiKey.viewapiKey.createapiKey.editapiKey.deletefile.downloadmaintenance.viewmaintenance.createmaintenance.editmaintenance.deletemaintenance.completerouting.managecustomizer.managemacro.viewmacro.createmacro.editmacro.deletemacro.runcard.viewcard.createcard.editcard.deletelayout.viewlayout.createlayout.editlayout.deleteclasswork.viewerclasswork.editorsequence.viewsequence.editqr.scanqr.manageinternal.shopifyqueue.adminpart.viewerpart.editorsku.viewersku.editororders.adminmaterial.viewermaterial.editorprinter.viewerprinter.editorprofile.viewerprofile.editorsettings.adminsubscription.admin

subjectrequired

enum

What is scanned to offer it: an entity type, or a pair key such as "blank+material_variant"

blankprinterprinter_slotmaterial_variantmaterial_instancematerial_variant+printermaterial_variant+printer_slotprinter_slot+printer_slotmaterial_instance+printermaterial_instance+printer_slotblank+material_instanceblank+material_variantblank+printerblank+printer_slot

Example Response

200 OK — application/json

[
  {
    "id": "printer.confirmReady",
    "label": "string",
    "description": "string",
    "subject": "blank",
    "permission": "organization.owner",
    "kind": "webhook",
    "destructive": true,
    "default": true,
    "entitlement": "string"
  }
]