Printago API
PATCH /v1/qr-tags/revoke

Revoke QR tags

A revoked tag resolves to a "revoked" message when scanned and runs no actions. Revoking a tag that is already revoked changes nothing.

Requires: qr.manage

Request Body

IDs of the tags to revoke

RevokeQrTagsRequest
idsrequired
string[]
min items: 1max items: 1000

Example Request

application/json 
{
  "ids": [
    "string"
  ]
}

Response Schema

QrTag[]
Array of QrTag, each with:
batchIdrequirednullable
string
pattern: ^[a-z0-9]{24}$
boundAtrequirednullable
string
format: date-time
boundByrequirednullable
string
createdAtrequired
string
format: date-time
displaySnapshotrequirednullable
object
Caption data captured when a tag is created, so a tag still describes its target after the target is deleted.
brandoptional
string
codeoptional
string
The short code printed on a blank tag so two blanks can be told apart. It stays after the blank is set up, and becomes a new spool's label code.
coloroptionalnullable
string
#RRGGBBAA, or several joined with ";" for multicolor filament
materialNameoptional
string
Variant tags
nameoptional
string
The printer's name for printer and slot tags; the variant's name for variant and spool tags
provideroptionalnullable
string
slotRefoptional
string
Slot tags: the slot as the app names it, such as A1/3 or S1
entityIdrequirednullable
string
The printerId for printer_slot tags; null while blank. A blank keeps its printed payload (t: 'blank') after it is set up; this row says what it is.
pattern: ^[a-z0-9]{24}$
entityTyperequired
"blank" | "printer" | "printer_slot" | "material_variant" | "material_instance"
blankprinterprinter_slotmaterial_variantmaterial_instance
idrequired
string
pattern: ^[A-Za-z0-9_-]{1,24}$
labelrequirednullable
string
lastScannedAtrequirednullable
string
format: date-time
payloadVersionrequired
number
printedAtrequirednullable
string
format: date-time
revokedAtrequirednullable
string
format: date-time
revokedByrequirednullable
string
scanCountrequired
number
slotAmsIndexrequirednullable
number
Slot identity for printer_slot tags; amsIndex -1 is the external spool
slotSlotIndexrequirednullable
number
statusrequired
"blank" | "active" | "revoked" | "orphaned"
blankactiverevokedorphaned
storeIdrequired
string
pattern: ^[a-z0-9]{24}$
updatedAtrequired
string
format: date-time

Example Response

200 OK — application/json 
[
  {
    "id": "string",
    "status": "blank",
    "entityType": "blank",
    "entityId": "string",
    "slotAmsIndex": 1,
    "slotSlotIndex": 1,
    "label": "string",
    "batchId": "string",
    "payloadVersion": 1,
    "displaySnapshot": {
      "name": "string",
      "provider": "string",
      "slotRef": "string",
      "materialName": "string",
      "brand": "string",
      "color": "string",
      "code": "string"
    },
    "printedAt": "2025-01-15T12:00:00.000Z",
    "boundAt": "2025-01-15T12:00:00.000Z",
    "boundBy": "string",
    "revokedAt": "2025-01-15T12:00:00.000Z",
    "revokedBy": "string",
    "lastScannedAt": "2025-01-15T12:00:00.000Z",
    "scanCount": 1,
    "storeId": "string",
    "updatedAt": "2025-01-15T12:00:00.000Z",
    "createdAt": "2025-01-15T12:00:00.000Z"
  }
]