Prepare an immutable label (Admin)

POST/manage/events/:eventId/label-print/jobs

Prepare an immutable label.

Auth	Login required

Path parameters

eventIdstringrequired

Event ID.

Request body

printerIdstringrequired

Registered printer ID.

entryIdstringoptional

Entry ID; omit only for an administrator direct test print.

locale"ja" | "en"optional

Display language; defaults to ja

previewHashstringoptional

Hash from the preview API. Changed content or paper settings cause 409 LABEL_PREVIEW_CHANGED without creating a job.

requestKeystringrequired

Idempotency key. Reuse for the same request; use a new key for explicit reprints.

delivery"DIRECT" | "STATION"required

Direct printing or a shared station

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 LabelPrintJob.

Request

curl https://api.4s.link/manage/events/EVENT_ID/label-print/jobs \
  -X POST \
  -H "Authorization: Bearer 4s_at_..." \
  -H "Content-Type: application/json" \
  -d '{
  "printerId": "printer-1",
  "entryId": "entry-1",
  "locale": "ja",
  "requestKey": "unique-request-key",
  "delivery": "DIRECT"
}'

Example response

{
  "id": "job-1",
  "printerId": "printer-1",
  "entryId": "entry-1",
  "state": "PREPARED",
  "delivery": "DIRECT",
  "media": "CONTINUOUS_62",
  "lengthMm": 60,
  "widthPx": 696,
  "heightPx": 639,
  "errorCode": null,
  "createdAt": "2026-09-18T00:00:00Z",
  "expiresAt": "2026-09-18T00:02:00Z"
}