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.

FieldTypeRequiredDescription
printer_idsuuid[]Yes
attestationobjectYes
outcomesobject[]No

Responses

StatusDescription
200Default Response
400Default Response
401Default Response
403Default Response
503Default Response

200 response fields

FieldTypeRequiredDescription
replayedbooleanYes
resultsobject[]Yes

400 response fields

FieldTypeRequiredDescription
errorstringYes
messagestringNo
codestringNo
statusCodeintegerNo

401 response fields

FieldTypeRequiredDescription
errorstringYes
messagestringNo
codestringNo
statusCodeintegerNo

403 response fields

FieldTypeRequiredDescription
errorstringYes
messagestringNo
codestringNo
statusCodeintegerNo

503 response fields

FieldTypeRequiredDescription
errorstringYes
messagestringNo
codestringNo
statusCodeintegerNo

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
    }
  ]
}