Open Inventory / Docs
EndpointsLabel printingLabel printers

Provision a shared Office printer

The API runs on your application instance. Schemas and field names come directly from the OpenAPI specification. Session-authenticated requests require a session on that instance.

POST
/label-printers

Requires a browser session with tokens.manage. Currently provisions 24 mm tape only. The returned iprt_ token is shown once and is restricted to this printer; store it in the agent configuration.

Authorization

adminSession
cookieauthjs.session-token<token>

Authenticated Auth.js browser session cookie; each operation declares its required permission. Not restricted to administrators. HTTPS deployments use the secure-prefixed cookie variant.

Header Parameters

X-Organization-ID?string

Organization membership selected for this request. User-bound credentials may select any active membership; standalone tokens may only repeat their pinned organization ID.

Formatuuid

Request Body

application/json
  1. body
name*string
Length1 <= length <= 120
tape?number
Default24

Response Body

Printer and one-time agent credential.

application/json
  1. response
printer*
token*string
Example Request
curl -X POST 'https://inventory.example.com/api/v1/label-printers' \  -H 'Content-Type: application/json' \  -d '{  "name": "string"}'
Example Response
{  "printer": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "name": "string",    "tape": 24  },  "token": "string"}

Disable a shared printer PATCH

Requires a browser session with tokens.manage. Revokes agent access and cancels queued jobs. To rotate credentials, provision a replacement printer.

Read the personal saved print list GET

Requires a user browser session with labels.read. Data is scoped to the current user and organization.