Events (Admin)
Register or update a printer (Admin)
POST
/manage/events/:eventId/label-print/printersRegister or update a printer.
| Auth | Login required |
|---|
Path parameters
eventIdstringrequiredEvent ID.
Request body
namestringrequiredPrinter name
serialNumberstringrequiredPhysical serial, trimmed and uppercased for locking
media"CONTINUOUS_62" | "CONTINUOUS_29" | "DIE_CUT_29_90" | "DIE_CUT_62_100"requiredMedia type
lengthMmnumberrequired30–300 for continuous tape; fixed at 90 for 29×90 or 100 for 62×100 die-cut labels
enabledbooleanoptionalWhether the printer is enabled
Notes
Requires event membership and participantsWrite or speakersWrite. Printer registration and test jobs without an entry additionally require eventWrite. HTTP or transfer success does not confirm physical printing. Never automatically retry an unknown result; inspect the printed output first. Do not log images, QR data or claimToken.
Response
Returns LabelPrinter.
Request
curl https://api.4s.link/manage/events/EVENT_ID/label-print/printers \-X POST \-H "Authorization: Bearer 4s_at_..." \-H "Content-Type: application/json" \-d '{"name": "example","serialNumber": "example","media": "CONTINUOUS_62","lengthMm": 0,"enabled": false}'
Example response
{"id": "printer-1","name": "Reception","serialNumber": "EXAMPLE123","media": "CONTINUOUS_62","lengthMm": 60,"enabled": true,"online": false,"heartbeatAt": null}