API Endpoint Reference / Printers
Delete Filament assignments without sending printer commands
POST https://api.printhiv3d.com/v1/printers/{id}/material-slots/clear-assignments
Operation ID clearFilamentAssignments. Requires the control API key scope.
Deletes the Filament assignment of each listed Printer material slot and sends no printer command. A request with `expectedVersion` names exactly one position and deletes its Filament assignment only while the saved version matches. A changed version answers 409 `assignment_changed`.
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
| Name | In | Type | Required | Description |
|---|
id | path | uuid | Yes | |
Request body
Content type application/json.
| Field | Type | Required | Description |
|---|
expectedVersion | object | No | Delete only while this saved version is current. The request then names exactly one position. |
positions | (integer | 254 | 255 | 512 | 516 | 520 | 524 | 528 | 532 | 536 | 540)[] | Yes | |
Responses
| Status | Description |
|---|
200 | Default Response |
400 | Default Response |
401 | Default Response |
403 | Default Response |
404 | Default Response |
409 | Default Response |
422 | Default Response |
500 | Default Response |
503 | Default Response |
200 response fields
| Field | Type | Required | Description |
|---|
reevaluations | object[] | No | |
slots | object[] | Yes | |
400 response fields
| Field | Type | Required | Description |
|---|
error | string | No | |
message | string | No | |
requestId | string | No | |
code | string | No | |
position | number | No | |
slots | object[] | No | |
reason | string | No | |
reevaluations | object[] | No | |
holdingJob | object | No | |
401 response fields
| Field | Type | Required | Description |
|---|
error | string | No | |
message | string | No | |
requestId | string | No | |
code | string | No | |
position | number | No | |
slots | object[] | No | |
reason | string | No | |
reevaluations | object[] | No | |
holdingJob | object | No | |
403 response fields
| Field | Type | Required | Description |
|---|
error | string | No | |
message | string | No | |
requestId | string | No | |
code | string | No | |
position | number | No | |
slots | object[] | No | |
reason | string | No | |
reevaluations | object[] | No | |
holdingJob | object | No | |
404 response fields
| Field | Type | Required | Description |
|---|
error | string | No | |
message | string | No | |
requestId | string | No | |
code | string | No | |
position | number | No | |
slots | object[] | No | |
reason | string | No | |
reevaluations | object[] | No | |
holdingJob | object | No | |
409 response fields
| Field | Type | Required | Description |
|---|
error | string | No | |
message | string | No | |
requestId | string | No | |
code | string | No | |
position | number | No | |
slots | object[] | No | |
reason | string | No | |
reevaluations | object[] | No | |
holdingJob | object | No | |
422 response fields
| Field | Type | Required | Description |
|---|
error | string | No | |
message | string | No | |
requestId | string | No | |
code | string | No | |
position | number | No | |
slots | object[] | No | |
reason | string | No | |
reevaluations | object[] | No | |
holdingJob | object | No | |
500 response fields
| Field | Type | Required | Description |
|---|
error | string | No | |
message | string | No | |
requestId | string | No | |
code | string | No | |
position | number | No | |
slots | object[] | No | |
reason | string | No | |
reevaluations | object[] | No | |
holdingJob | object | No | |
503 response fields
| Field | Type | Required | Description |
|---|
error | string | No | |
message | string | No | |
requestId | string | No | |
code | string | No | |
position | number | No | |
slots | object[] | No | |
reason | string | No | |
reevaluations | object[] | No | |
holdingJob | object | No | |
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"
}
}
}
]
}