API Endpoint Reference / Printers

Record an installed nozzle type and diameter in Hive

PUT https://api.printhiv3d.com/v1/printers/{id}/nozzle-configurations/{targetKey}

Operation ID savePrinterNozzleConfiguration. Requires the control API key scope.

Organization admins and owners, or control-scoped API keys. Host credentials are rejected. Records configuration in Hive without changing firmware reports.

Parameters

NameInTypeRequiredDescription
idpathuuidYes
targetKeypathstringYes

Request body

Content type application/json.

FieldTypeRequiredDescription
type"hardened_steel" | "stainless_steel" | "brass" | "tungsten_carbide"Yes
diameterMm0.2 | 0.25 | 0.3 | 0.4 | 0.5 | 0.6 | 0.8 | 1Yes

Responses

StatusDescription
200Default Response

200 response fields

FieldTypeRequiredDescription
targetKeystringYes
pairobjectYes
updatedAtdate-timeYes

Example 200 response

{
  "targetKey": "single",
  "pair": {
    "type": "hardened_steel",
    "diameterMm": 0.4
  },
  "updatedAt": "2026-11-13T08:00:00.000Z"
}