Search dataset conversions by conversion ID or file path

Path parameters

• /{id}

  stringUUID

  //

Query string parameters

• ?limit=

  uint32

  //

• &page_token=

  string

  //

• &q=

  string

  //

• &sort_by=

  "created_at_ascending"+5▾

  • //Sort by created_at in increasing order.
    "created_at_ascending"
  • //Sort by created_at in decreasing order.
    "created_at_descending"
  • //Sort by status in increasing order.
    "status_ascending"
  • //Sort by status in decreasing order.
    "status_descending"
  • //Sort by updated_at in increasing order.
    "updated_at_ascending"
  • //Sort by updated_at in decreasing order.
    "updated_at_descending"

  //

Response

• 200 OK

  • +

    { ... }

    //

    • next_page:

      string,

      //
    • +

      items:

      [[ ... ]

      //

      • +

        { ... }

        //

        • completed_at:

          stringISO-8601,

          //

        • created_at:

          stringISO-8601,

          //

        • dataset_id:

          stringUUID,

          //

        • file_etag:

          string,

          //

        • file_path:

          string,

          //

        • file_size:

          numberint64,

          //

        • id:

          stringUUID,

          //

        • importer_version:

          string,

          //

        • manual_kcl_override_active:

          boolean,

          //

        • manual_kcl_override_updated_at:

          stringISO-8601,

          //

        • metadata:

          ,

          //

        • raw_kcl_similarity_score:

          numberdouble,

          //

        • salon_kcl_similarity_score:

          numberdouble,

          //

        • started_at:

          stringISO-8601,

          //

        • status_message:

          string,

          //

        • updated_at:

          stringISO-8601,

          //

        • phase:

          "queued"+11▾

          • //Phase index `0`: waiting for a worker to begin processing this conversion.
            "queued"
          • //Phase index `1`: generating original file metadata.
            "zoo_generated_original_metadata"
          • //Phase index `2`: creating a snapshot of the original source model.
            "snapshot_original"
          • //Phase index `3`: discovering optional user-provided metadata files (`.json`, `.yaml`, `.yml`, `.toml`, `.txt`) stored next to the source CAD file.
            "user_provided_metadata"
          • //Phase index `4`: loading a persisted manual KCL override instead of regenerating KCL automatically.
            "manual_kcl_override"
          • //Phase index `5`: converting the source model into raw KCL.
            "convert_raw_kcl"
          • //Phase index `6`: generating raw KCL metadata.
            "zoo_generated_raw_kcl_metadata"
          • //Phase index `7`: creating a snapshot of the raw KCL result.
            "snapshot_raw_kcl"
          • //Phase index `8`: running the salon/refactor step that produces polished KCL.
            "salon"
          • //Phase index `9`: generating salon KCL metadata.
            "zoo_generated_salon_kcl_metadata"
          • //Phase index `10`: creating a snapshot of the salon/refactored KCL.
            "snapshot_salon_kcl"
          • //Phase index `11`: conversion finished successfully.
            "completed"

          ,

          //

        • status:

          "queued"+7▾

          • //Pending conversion.
            "queued"
          • //The file will not be converted.
            "canceled"
          • //The file is currently being converted. If `started_at` passes a certain threshold, we assume it got dropped and will retry.
            "in_progress"
          • //Conversion finished with the result available at `output_path`.
            "success"
          • //Conversion failed due to user providing a broken file, such as it being empty.
            "error_user"
          • //Conversion produced a raw KCL result whose geometry diverged from the source model beyond the accepted threshold.
            "error_geometry_mismatch"
          • //Conversion failed because we didn't know how to handle the file. The conversion should be retried with a new converter version.
            "error_unsupported"
          • //Conversion failed with some other unrecoverable error. The conversion should be retried with a new converter version.
            "error_internal"

          //

        }

      ]

    }