Management API
Use the Printix Management API to manage the printers, print queues, sites, and networks of your tenant programmatically.
The Printix Management API is a REST API. With it, you can manage your Printix tenant from scripts, automation tools, or AI agents, instead of in Printix Administrator.
The Management API is separate from the Printix Cloud Print API, which is for submitting and releasing print jobs.
You can use the Management API to manage the following:
-
Sites: Create, read, list, update, move, and delete sites.
-
Networks: Create, read, list, update, and delete networks. Deleting a network also deletes the printers on it.
-
Printers: Create, read, list, update, and delete printers. Deleting a printer also deletes all its print queues.
To create a printer, you specify its name, network, and IP address. Printix discovers the printer and creates it asynchronously. The API returns a task that you check until it's complete.
-
Print queues: Create, read, list, update, and delete print queues. You create a print queue on a printer.
Changes take effect immediately, and deleted items can't be restored.
The Management API doesn't cover users and groups, computers, or capture workflows.
To use the Management API:
-
In Printix Administrator, create an application of type "Management API" and select the permissions that it needs.
The application gets a client ID and a client secret.
-
The application uses the client ID and the client secret to get an access token from https://auth.printix.net/oauth/token with the OAuth 2.0 client credentials flow.
-
With the access token, the application calls the API at https://management.printix.net/management/v1, with the tenant ID in the path.
For tenants in the US data center, the hosts are auth.us.printix.net and management.us.printix.net.
The Management API serves its own documentation, so the documentation always matches the API version in your data center:
-
Swagger UI: View the API reference and try requests in a browser at https://management.printix.net/ui. For the US data center, use https://management.us.printix.net/ui.
-
OpenAPI specification: Use https://management.printix.net/management/v1/api-docs, or https://management.us.printix.net/management/v1/api-docs for the US data center, with tools that read OpenAPI, such as code generators or Swagger Editor.
The Management API isn't available for tenants that have only Power PDF.