Search dataset conversions by conversion ID or file path

Parameters

• id

  string / UUID

  required

• limit

  integer

  optional

• page_token

  string

  optional

• q

  string

  required

• sort_by

  string

  required

  Possible values

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

Returns

• 200 OK

  successful operation

  Name

  Type

  Req.

  body

  object

  optional

  Object Properties

  • items

    array

    optional

    Array of

    • completed_at

      string / ISO-8601

      optional

    • created_at

      string / ISO-8601

      optional

    • dataset_id

      string / UUID

      optional

    • file_etag

      string

      optional

    • file_path

      string

      optional

    • file_size

      integer

      optional

    • id

      string / UUID

      optional

    • importer_version

      string

      optional

    • metadata

      optional

    • phase

      string

      optional

      Possible values

      • queued:  Phase index `0`: waiting for a worker to begin processing this conversion.
      • snapshot_original:  Phase index `1`: creating a snapshot of the original source model.
      • convert_raw_kcl:  Phase index `2`: converting the source model into raw KCL.
      • snapshot_raw_kcl:  Phase index `3`: creating a snapshot of the raw KCL result.
      • salon:  Phase index `4`: running the salon/refactor step that produces polished KCL.
      • snapshot_salon_kcl:  Phase index `5`: creating a snapshot of the salon/refactored KCL.
      • completed:  Phase index `6`: conversion finished successfully.

    • started_at

      string / ISO-8601

      optional

    • status

      string

      optional

      Possible values

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

    • status_message

      string

      optional

    • updated_at

      string / ISO-8601

      optional

  • next_page

    string

    optional