Start, report, cancel or resolve a job (Admin)

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

Start, report, cancel or resolve a job.

Auth	Login required

Path parameters

eventIdstringrequired

Event ID.

jobIdstringrequired

Job ID.

Request body

action"start" | "result" | "cancel" | "resolve"required

Operation to perform

claimTokenstringoptional

Token returned by claim; required for start/result.

state"COMPLETED" | "FAILED" | "UNKNOWN"optional

state

errorCodestringoptional

Error code without sensitive data

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.

start/result require the claiming user and claimToken. Resolve UNKNOWN only after checking the printed output. Cancel is limited to PREPARED/QUEUED jobs.

Response

Returns LabelPrintJob.

Request

curl https://api.4s.link/manage/events/EVENT_ID/label-print/jobs/JOB_ID/transition \
  -X POST \
  -H "Authorization: Bearer 4s_at_..." \
  -H "Content-Type: application/json" \
  -d '{
  "action": "result",
  "claimToken": "example-token",
  "state": "COMPLETED"
}'

Example response

{
  "id": "job-1",
  "printerId": "printer-1",
  "entryId": "entry-1",
  "state": "COMPLETED",
  "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"
}