patch/v1/printers/{id}/ready

Request

  • Base URL: https://api.printhiv3d.com
  • URL: https://api.printhiv3d.com/v1/printers/{id}/ready
  • Auth: none declared

Path parameters

idstring required

Request body

readyboolean required
ready_source'operator_override' | 'null' nullable

Explicit source for a ready=true operator override

ready_updated_source'operator_override'

Explicit transition owner for an operator-initiated ready=false command

metadataobject nullable
job_idnumber nullable
event_type'operator:manual_verification:success' | 'operator:manual_verification:failed' | 'operator:manual_verification:cancelled' | 'operator:manual_verification:skipped' | 'null' nullable
failure_reason'blob_of_death' | 'extrusion_issue' | 'nozzle_clog' | 'under_extrusion' | 'over_extrusion' | 'spaghetti' | 'layer_shift' | 'bed_adhesion' | 'stringing' | 'warping' | 'z_banding' | 'filament_runout' | 'power_failure' | 'mechanical_failure' | 'other' nullable

Reason for failure when event_type is failed (for training data)

organizationIdstring

Organization ID (optional, defaults to user's primary organization)

requeue_failedboolean nullable

When true and the job belongs to a batch, requeue the failed job for the batch

Response

Default Response

successboolean required
pendingboolean required
messagestring required
next_print_job_idinteger nullable required

Print Job Smart Queue Selection names from stored evidence after the printer becomes ready. This is advisory, not a claim or reservation: the Host's later claim can differ after live material refresh or concurrent changes. Null when ready=false, no job is selected, or Selection could not run.

Changes

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • warning

      added the new attest_unresolved_outcome enum value to the /// response property for the response status

    • warning

      added the new resolve_unresolved_outcome enum value to the / response property for the response status

    • info

      added the required property // to the response with the status