Claim a print job (Admin)

POST/manage/events/:eventId/label-print/printers/:printerId/claim

Claim a print job.

Auth	Login required

Path parameters

eventIdstringrequired

Event ID.

printerIdstringrequired

Registered printer ID.

Request body

sessionIdstringrequired

Station or claimant session identifier.

jobIdstringoptional

Job ID.

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.

Shared stations omit jobId and poll every second. Direct printing specifies a jobId owned by the caller. Claims expire after 30 seconds.

Response

Field	Type	Description
`job`	ClaimedLabelPrintJob \| null	Claimed job and claimToken; null when no job is available

Request

curl https://api.4s.link/manage/events/EVENT_ID/label-print/printers/PRINTER_ID/claim \
  -X POST \
  -H "Authorization: Bearer 4s_at_..." \
  -H "Content-Type: application/json" \
  -d '{
  "sessionId": "example",
  "jobId": "example"
}'

Example response

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