API Endpoint Reference / Printers

Delete Hive overrides without sending printer commands

Deprecated. Use Delete Filament assignments without sending printer commands (POST /v1/printers/{id}/material-slots/clear-assignments) instead. This operation keeps working, and no removal date is set.

POST https://api.printhiv3d.com/v1/printers/{id}/filaments/clear

Operation ID clearPrinterFilaments. Requires the control API key scope.

Requires an organization API key with control scope or an authenticated organization session. Host credentials are rejected, including Host-bound wildcard keys. Legacy unbound wildcard keys are accepted.

Parameters

NameInTypeRequiredDescription
idpathuuidYes

Request body

Content type application/json.

FieldTypeRequiredDescription
positions(integer | 254 | 255 | 512 | 516 | 520 | 524 | 528 | 532 | 536 | 540)[]Yes

Responses

StatusDescription
200Default Response
400Default Response
401Default Response
403Default Response
404Default Response
409Default Response
422Default Response
500Default Response
503Default Response

200 response fields

FieldTypeRequiredDescription
reevaluationsobject[]No
slotsobject[]Yes

400 response fields

FieldTypeRequiredDescription
errorstringNo
messagestringNo
requestIdstringNo
codestringNo
positionnumberNo
slotsobject[]No
reasonstringNo
reevaluationsobject[]No
holdingJobobjectNo

401 response fields

FieldTypeRequiredDescription
errorstringNo
messagestringNo
requestIdstringNo
codestringNo
positionnumberNo
slotsobject[]No
reasonstringNo
reevaluationsobject[]No
holdingJobobjectNo

403 response fields

FieldTypeRequiredDescription
errorstringNo
messagestringNo
requestIdstringNo
codestringNo
positionnumberNo
slotsobject[]No
reasonstringNo
reevaluationsobject[]No
holdingJobobjectNo

404 response fields

FieldTypeRequiredDescription
errorstringNo
messagestringNo
requestIdstringNo
codestringNo
positionnumberNo
slotsobject[]No
reasonstringNo
reevaluationsobject[]No
holdingJobobjectNo

409 response fields

FieldTypeRequiredDescription
errorstringNo
messagestringNo
requestIdstringNo
codestringNo
positionnumberNo
slotsobject[]No
reasonstringNo
reevaluationsobject[]No
holdingJobobjectNo

422 response fields

FieldTypeRequiredDescription
errorstringNo
messagestringNo
requestIdstringNo
codestringNo
positionnumberNo
slotsobject[]No
reasonstringNo
reevaluationsobject[]No
holdingJobobjectNo

500 response fields

FieldTypeRequiredDescription
errorstringNo
messagestringNo
requestIdstringNo
codestringNo
positionnumberNo
slotsobject[]No
reasonstringNo
reevaluationsobject[]No
holdingJobobjectNo

503 response fields

FieldTypeRequiredDescription
errorstringNo
messagestringNo
requestIdstringNo
codestringNo
positionnumberNo
slotsobject[]No
reasonstringNo
reevaluationsobject[]No
holdingJobobjectNo

Example 200 response

{
  "reevaluations": [],
  "slots": [
    {
      "position": 0,
      "assignment": null,
      "database": "cleared",
      "record": "cleared",
      "printerSync": {
        "status": "skipped",
        "reason": "clear_override_only"
      },
      "observation": {
        "status": "reported",
        "observedAt": "2026-11-04T18:00:00.000Z",
        "reported": {
          "materialType": "PLA",
          "color": "#FFFFFF",
          "filamentId": "GFA00",
          "settingId": "GFA00"
        }
      }
    }
  ]
}