patch/v1/printers/{id}/ready

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

Changes

Changed in 6 of the 42 revisions of this API.1213

    • ●

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

      response-property-enum-value-added

    • ●

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

      response-property-enum-value-added

    • ○

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

      response-required-property-added

    • ○

      the response property became required for the status

      response-property-became-required

    • ○

      the response property became required for the status

      response-property-became-required

    • ○

      added the required property to the response with the status

      response-required-property-added

    • ○

      added the success response with the status

      response-success-status-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

  • b987927f299615See the full diff
    • ▲

      request property was restricted to a list of enum values

      request-property-became-enum

    • ○

      added the new operator:manual_verification:cancelled enum value to the request property

      request-property-enum-value-added

    • ○

      added the new operator:manual_verification:failed enum value to the request property

      request-property-enum-value-added

    • ○

      added the new operator:manual_verification:skipped enum value to the request property

      request-property-enum-value-added

    • ○

      added the new operator:manual_verification:success enum value to the request property

      request-property-enum-value-added

    • ○

      added the new undefined enum value to the request property

      request-property-enum-value-added

    • ○

      added the non-success response with the status

      response-non-success-status-added

    • ○

      added the new optional request property

      new-optional-request-property