Fetch the metadata and converted output for a single dataset conversion
Path parameters
/{id}
stringUUID///{conversion_id}
stringUUID//
Response
- 200 OK
- //
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:
string,//manual_kcl_override_active:
boolean,//manual_kcl_override_updated_at:
stringISO-8601,//metadata:
,//output:
string,//raw_kcl_output:
string,//raw_kcl_similarity_score:
numberdouble,//salon_kcl_output:
string,//salon_kcl_similarity_score:
numberdouble,//started_at:
stringISO-8601,//status_message:
string,//updated_at:
stringISO-8601,//:
[[ ... ],//- //
data_base64:
stringBASE64,//mime_type:
string//
}
]
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"
//:
[[ ... ],//- //
data_base64:
stringBASE64,//mime_type:
string//
}
]
:
[[ ... ],//- //
data_base64:
stringBASE64,//mime_type:
string//
}
]
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"
//
}
Examples
get
/org/datasets/{id}/conversions/{conversion_id}200 OK
Response