Printago API
PATCH /v1/printers/{id}/rename

Rename a printer

Change a printer's display name

Requires: printer.edit

Path Parameters

id required
string
The printer's unique identifier

Request Body

New name for the printer

RenamePrinterOptions
namerequired
string

Example Request

application/json
{
  "name": "string"
}

Response Schema

Printer
bedSizerequired
object
{x,y,z} mm build volume, denormalized from the machine profile's printable_area/printable_height. Cache only — refreshed whenever the printer's machine profile changes; the profile is the source of truth.
commMethodrequired
any
confirmedReadyrequired
boolean
continuousPrintrequired
boolean
createdAtrequired
string
format: date-time
deviceIdrequired
string
enabledrequired
boolean
fabmaticRemainingJobsrequired
number
idrequired
string
pattern: ^[a-z0-9]{24}$
integrationIdrequired
string
integrationTyperequired
any
isAvailablerequired
boolean
isInMaintenanceoptional
boolean
isOnlinerequired
boolean
lastMaintenanceOfflineAtrequired
string
lastMaintenanceOnlineAtrequired
string
lastPrintedAtrequired
string
lifetimeJobCountrequired
number
lifetimePrintHoursrequired
number
machineSystemProfileIdrequired
number
machineUserProfileIdrequired
string
metadatarequired
object
modelNamerequired
string
Human-readable model name (e.g. "P1S", "Snapmaker U1", "Prusa CORE One")
namerequired
string
nozzleDiameterrequired
string
printerAdapterBindingsPatchrequired
object
Per-printer adapter binding override applied last.
printerCapabilityPatchrequired
object
Per-printer capability override applied last (web Advanced Capabilities panel).
printingJobIdrequired
string
processSystemProfileIdrequired
number
processUserProfileIdrequired
string
providerrequired
any
providerConfigrequired
object
proxyClientIdrequired
string
storeIdrequired
string
pattern: ^[a-z0-9]{24}$
tagsoptional
string[]
updatedAtrequired
string
format: date-time
vendorModelIdrequired
number
vendorNamerequired
string
Vendor/manufacturer name (e.g. "Bambu Lab", "Prusa", "Snapmaker")

Example Response

200 OK — application/json
{
  "name": "string",
  "nozzleDiameter": "string",
  "enabled": true,
  "tags": [
    "string"
  ],
  "confirmedReady": true,
  "isAvailable": true,
  "isOnline": true,
  "continuousPrint": true,
  "lifetimePrintHours": 1,
  "lifetimeJobCount": 1,
  "isInMaintenance": true,
  "id": "string",
  "storeId": "string",
  "createdAt": "2026-08-24T03:58:55.967Z",
  "updatedAt": "2026-08-24T03:58:55.967Z"
}