Files
dashback/docs/api/routes/printeragent.put.md
2026-10-30 16:48:39 +01:00

1.1 KiB

PUT /printeragent

Protected. Requires a valid session cookie (credentials: 'include').

Create printer agent

Creates an unpaired printer agent for the selected company. The pairingpin is randomly generated server-side and returned in the response.

Body (JSON)

Field Required Type Description
name yes string
{
  "name": "Bar printer"
}

Response 200

Created printer agent with generated pairingpin

{
  "printeragent": {
    "id": 1,
    "companyId": 1,
    "name": "…",
    "token": "…",
    "pairingpin": "…",
    "pairedAt": "…",
    "clientserial": "…",
    "clientmodel": "…",
    "clientstate": "…",
    "agentversion": "…",
    "lastseenAt": "…",
    "updatedAt": "…"
  }
}

Errors

Status Description
400 No company selected or invalid input — {"error":"…"}
401 Unauthorized — {"error":"…"}
403 Not authorized — {"error":"…"}
404 Company not found — {"error":"…"}

Generated from @openapi JSDoc. Do not edit by hand — run npm run docs:api.