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
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | uuid | Yes | |
targetKey | path | string | Yes |
Request body
Content type application/json.
| Field | Type | Required | Description |
|---|---|---|---|
type | "hardened_steel" | "stainless_steel" | "brass" | "tungsten_carbide" | Yes | |
diameterMm | 0.2 | 0.25 | 0.3 | 0.4 | 0.5 | 0.6 | 0.8 | 1 | Yes |
Responses
| Status | Description |
|---|---|
200 | Default Response |
200 response fields
| Field | Type | Required | Description |
|---|---|---|---|
targetKey | string | Yes | |
pair | object | Yes | |
updatedAt | date-time | Yes |
Example 200 response
{
"targetKey": "single",
"pair": {
"type": "hardened_steel",
"diameterMm": 0.4
},
"updatedAt": "2026-11-13T08:00:00.000Z"
}