API Endpoint Reference / Printers
Attest that an operator cleared printer beds
POST https://api.printhiv3d.com/v1/printers/operator-ready
Operation ID attestOperatorReady. Requires the control API key scope.
Records operator identity, optional print verdicts, and readiness atomically. Attestations expire after five minutes. Final results replay without changing readiness; temporary refusals can retry with the same key. Batch replacements run after commit.
Request body
Content type application/json.
| Field | Type | Required | Description |
|---|
printer_ids | uuid[] | Yes | |
attestation | object | Yes | |
outcomes | object[] | No | |
Responses
| Status | Description |
|---|
200 | Default Response |
400 | Default Response |
401 | Default Response |
403 | Default Response |
503 | Default Response |
200 response fields
| Field | Type | Required | Description |
|---|
replayed | boolean | Yes | |
results | object[] | Yes | |
400 response fields
| Field | Type | Required | Description |
|---|
error | string | Yes | |
message | string | No | |
code | string | No | |
statusCode | integer | No | |
401 response fields
| Field | Type | Required | Description |
|---|
error | string | Yes | |
message | string | No | |
code | string | No | |
statusCode | integer | No | |
403 response fields
| Field | Type | Required | Description |
|---|
error | string | Yes | |
message | string | No | |
code | string | No | |
statusCode | integer | No | |
503 response fields
| Field | Type | Required | Description |
|---|
error | string | Yes | |
message | string | No | |
code | string | No | |
statusCode | integer | No | |
Example 200 response
{
"replayed": false,
"results": [
{
"printer_id": "7d3f1c2a-5b8e-4f6a-9c1d-2e4b6a8c0f13",
"audit_id": "a91d4f7c-3e2b-4a6d-8c5f-0b7e2d9a4c18",
"job_id": null,
"result": "ready",
"outcome": "not_applicable",
"requeue": "not_requested",
"previous_readiness": {
"ready": false,
"ready_source": null
},
"new_readiness": {
"ready": true,
"ready_source": "operator_override"
},
"replayed": false
}
]
}