API → API CallsGet an async operation

Parameters

Name

Type

Req.

  • id

    string / UUID
    required

Returns

  • 200 OK

    successful operation

    Name

    Type

    Req.

    body

    oneOf
    optional
    One of
    • file_conversion

      object
      optional
      Object Properties
      • completed_at

        string / ISO-8601
        optional
      • created_at

        string / ISO-8601
        optional
      • error

        string
        optional
      • id

        string / UUID
        optional
      • output_format

        string
        optional
        Possible values
        • fbx:  Autodesk Filmbox (FBX) format. <https://en.wikipedia.org/wiki/FBX>
        • glb:  Binary glTF 2.0. This is a single binary with .glb extension. This is better if you want a compressed format as opposed to the human readable glTF that lacks compression.
        • gltf:  glTF 2.0. Embedded glTF 2.0 (pretty printed). Single JSON file with .gltf extension binary data encoded as base64 data URIs. The JSON contents are pretty printed. It is human readable, single file, and you can view the diff easily in a git commit.
        • obj:  The OBJ file format. <https://en.wikipedia.org/wiki/Wavefront_.obj_file> It may or may not have an an attached material (mtl // mtllib) within the file, but we interact with it as if it does not.
        • ply:  The PLY file format. <https://en.wikipedia.org/wiki/PLY_(file_format)>
        • step:  The STEP file format. <https://en.wikipedia.org/wiki/ISO_10303-21>
        • stl:  The STL file format. <https://en.wikipedia.org/wiki/STL_(file_format)>
      • output_format_options

        oneOf
        optional
        One of
        • fbx

          object
          optional
          Object Properties
          • storage

            string
            optional
            Possible values
            • ascii:  ASCII FBX encoding.
            • binary:  Binary FBX encoding.
          • type

            string
            optional
            Possible values
            • fbx
        • gltf

          object
          optional
          Object Properties
          • presentation

            string
            optional
            Possible values
            • compact:  Condense the JSON into the smallest possible size.
            • pretty:  Expand the JSON into a more human readable format. This is the default setting.
          • storage

            string
            optional
            Possible values
            • binary:  Binary glTF 2.0. This is a single binary with .glb extension.
            • standard:  Standard glTF 2.0. This is a JSON file with .gltf extension paired with a separate binary blob file with .bin extension.
            • embedded:  Embedded glTF 2.0. Single JSON file with .gltf extension binary data encoded as base64 data URIs. This is the default setting.
          • type

            string
            optional
            Possible values
            • gltf
        • obj

          object
          optional
          Object Properties
          • coords

            object
            optional
            Object Properties
            • forward

              object
              optional
              Object Properties
              • axis

                string
                optional
                Possible values
                • y:  'Y' axis.
                • z:  'Z' axis.
              • direction

                string
                optional
                Possible values
                • positive:  Increasing numbers.
                • negative:  Decreasing numbers.
            • up

              object
              optional
              Object Properties
              • axis

                string
                optional
                Possible values
                • y:  'Y' axis.
                • z:  'Z' axis.
              • direction

                string
                optional
                Possible values
                • positive:  Increasing numbers.
                • negative:  Decreasing numbers.
          • type

            string
            optional
            Possible values
            • obj
          • units

            string
            optional
            Possible values
            • cm:  Centimeters <https://en.wikipedia.org/wiki/Centimeter>
            • ft:  Feet <https://en.wikipedia.org/wiki/Foot_(unit)>
            • in:  Inches <https://en.wikipedia.org/wiki/Inch>
            • m:  Meters <https://en.wikipedia.org/wiki/Meter>
            • mm:  Millimeters <https://en.wikipedia.org/wiki/Millimeter>
            • yd:  Yards <https://en.wikipedia.org/wiki/Yard>
        • ply

          object
          optional
          Object Properties
          • coords

            object
            optional
            Object Properties
            • forward

              object
              optional
              Object Properties
              • axis

                string
                optional
                Possible values
                • y:  'Y' axis.
                • z:  'Z' axis.
              • direction

                string
                optional
                Possible values
                • positive:  Increasing numbers.
                • negative:  Decreasing numbers.
            • up

              object
              optional
              Object Properties
              • axis

                string
                optional
                Possible values
                • y:  'Y' axis.
                • z:  'Z' axis.
              • direction

                string
                optional
                Possible values
                • positive:  Increasing numbers.
                • negative:  Decreasing numbers.
          • selection

            oneOf
            optional
            One of
            • default_scene

              object
              optional
              Object Properties
              • type

                string
                optional
                Possible values
                • default_scene
            • scene_by_index

              object
              optional
              Object Properties
              • index

                integer
                optional
              • type

                string
                optional
                Possible values
                • scene_by_index
            • scene_by_name

              object
              optional
              Object Properties
              • name

                string
                optional
              • type

                string
                optional
                Possible values
                • scene_by_name
            • mesh_by_index

              object
              optional
              Object Properties
              • index

                integer
                optional
              • type

                string
                optional
                Possible values
                • mesh_by_index
            • mesh_by_name

              object
              optional
              Object Properties
              • name

                string
                optional
              • type

                string
                optional
                Possible values
                • mesh_by_name
          • storage

            string
            optional
            Possible values
            • ascii:  Write numbers in their ascii representation (e.g. -13, 6.28, etc.). Properties are separated by spaces and elements are separated by line breaks.
            • binary_little_endian:  Encode payload as binary using little endian.
            • binary_big_endian:  Encode payload as binary using big endian.
          • type

            string
            optional
            Possible values
            • ply
          • units

            string
            optional
            Possible values
            • cm:  Centimeters <https://en.wikipedia.org/wiki/Centimeter>
            • ft:  Feet <https://en.wikipedia.org/wiki/Foot_(unit)>
            • in:  Inches <https://en.wikipedia.org/wiki/Inch>
            • m:  Meters <https://en.wikipedia.org/wiki/Meter>
            • mm:  Millimeters <https://en.wikipedia.org/wiki/Millimeter>
            • yd:  Yards <https://en.wikipedia.org/wiki/Yard>
        • step

          object
          optional
          Object Properties
          • coords

            object
            optional
            Object Properties
            • forward

              object
              optional
              Object Properties
              • axis

                string
                optional
                Possible values
                • y:  'Y' axis.
                • z:  'Z' axis.
              • direction

                string
                optional
                Possible values
                • positive:  Increasing numbers.
                • negative:  Decreasing numbers.
            • up

              object
              optional
              Object Properties
              • axis

                string
                optional
                Possible values
                • y:  'Y' axis.
                • z:  'Z' axis.
              • direction

                string
                optional
                Possible values
                • positive:  Increasing numbers.
                • negative:  Decreasing numbers.
          • type

            string
            optional
            Possible values
            • step
        • stl

          object
          optional
          Object Properties
          • coords

            object
            optional
            Object Properties
            • forward

              object
              optional
              Object Properties
              • axis

                string
                optional
                Possible values
                • y:  'Y' axis.
                • z:  'Z' axis.
              • direction

                string
                optional
                Possible values
                • positive:  Increasing numbers.
                • negative:  Decreasing numbers.
            • up

              object
              optional
              Object Properties
              • axis

                string
                optional
                Possible values
                • y:  'Y' axis.
                • z:  'Z' axis.
              • direction

                string
                optional
                Possible values
                • positive:  Increasing numbers.
                • negative:  Decreasing numbers.
          • selection

            oneOf
            optional
            One of
            • default_scene

              object
              optional
              Object Properties
              • type

                string
                optional
                Possible values
                • default_scene
            • scene_by_index

              object
              optional
              Object Properties
              • index

                integer
                optional
              • type

                string
                optional
                Possible values
                • scene_by_index
            • scene_by_name

              object
              optional
              Object Properties
              • name

                string
                optional
              • type

                string
                optional
                Possible values
                • scene_by_name
            • mesh_by_index

              object
              optional
              Object Properties
              • index

                integer
                optional
              • type

                string
                optional
                Possible values
                • mesh_by_index
            • mesh_by_name

              object
              optional
              Object Properties
              • name

                string
                optional
              • type

                string
                optional
                Possible values
                • mesh_by_name
          • storage

            string
            optional
            Possible values
            • ascii:  Plaintext encoding.
            • binary:  Binary STL encoding. This is the default setting.
          • type

            string
            optional
            Possible values
            • stl
          • units

            string
            optional
            Possible values
            • cm:  Centimeters <https://en.wikipedia.org/wiki/Centimeter>
            • ft:  Feet <https://en.wikipedia.org/wiki/Foot_(unit)>
            • in:  Inches <https://en.wikipedia.org/wiki/Inch>
            • m:  Meters <https://en.wikipedia.org/wiki/Meter>
            • mm:  Millimeters <https://en.wikipedia.org/wiki/Millimeter>
            • yd:  Yards <https://en.wikipedia.org/wiki/Yard>
      • outputs

        object
        optional
      • src_format

        string
        optional
        Possible values
        • fbx:  Autodesk Filmbox (FBX) format. <https://en.wikipedia.org/wiki/FBX>
        • gltf:  glTF 2.0.
        • obj:  The OBJ file format. <https://en.wikipedia.org/wiki/Wavefront_.obj_file> It may or may not have an an attached material (mtl // mtllib) within the file, but we interact with it as if it does not.
        • ply:  The PLY file format. <https://en.wikipedia.org/wiki/PLY_(file_format)>
        • sldprt:  SolidWorks part (SLDPRT) format.
        • step:  The STEP file format. <https://en.wikipedia.org/wiki/ISO_10303-21>
        • stl:  The STL file format. <https://en.wikipedia.org/wiki/STL_(file_format)>
      • src_format_options

        oneOf
        optional
        One of
        • fbx

          object
          optional
          Object Properties
          • type

            string
            optional
            Possible values
            • fbx
        • gltf

          object
          optional
          Object Properties
          • type

            string
            optional
            Possible values
            • gltf
        • obj

          object
          optional
          Object Properties
          • coords

            object
            optional
            Object Properties
            • forward

              object
              optional
              Object Properties
              • axis

                string
                optional
                Possible values
                • y:  'Y' axis.
                • z:  'Z' axis.
              • direction

                string
                optional
                Possible values
                • positive:  Increasing numbers.
                • negative:  Decreasing numbers.
            • up

              object
              optional
              Object Properties
              • axis

                string
                optional
                Possible values
                • y:  'Y' axis.
                • z:  'Z' axis.
              • direction

                string
                optional
                Possible values
                • positive:  Increasing numbers.
                • negative:  Decreasing numbers.
          • type

            string
            optional
            Possible values
            • obj
          • units

            string
            optional
            Possible values
            • cm:  Centimeters <https://en.wikipedia.org/wiki/Centimeter>
            • ft:  Feet <https://en.wikipedia.org/wiki/Foot_(unit)>
            • in:  Inches <https://en.wikipedia.org/wiki/Inch>
            • m:  Meters <https://en.wikipedia.org/wiki/Meter>
            • mm:  Millimeters <https://en.wikipedia.org/wiki/Millimeter>
            • yd:  Yards <https://en.wikipedia.org/wiki/Yard>
        • ply

          object
          optional
          Object Properties
          • coords

            object
            optional
            Object Properties
            • forward

              object
              optional
              Object Properties
              • axis

                string
                optional
                Possible values
                • y:  'Y' axis.
                • z:  'Z' axis.
              • direction

                string
                optional
                Possible values
                • positive:  Increasing numbers.
                • negative:  Decreasing numbers.
            • up

              object
              optional
              Object Properties
              • axis

                string
                optional
                Possible values
                • y:  'Y' axis.
                • z:  'Z' axis.
              • direction

                string
                optional
                Possible values
                • positive:  Increasing numbers.
                • negative:  Decreasing numbers.
          • type

            string
            optional
            Possible values
            • ply
          • units

            string
            optional
            Possible values
            • cm:  Centimeters <https://en.wikipedia.org/wiki/Centimeter>
            • ft:  Feet <https://en.wikipedia.org/wiki/Foot_(unit)>
            • in:  Inches <https://en.wikipedia.org/wiki/Inch>
            • m:  Meters <https://en.wikipedia.org/wiki/Meter>
            • mm:  Millimeters <https://en.wikipedia.org/wiki/Millimeter>
            • yd:  Yards <https://en.wikipedia.org/wiki/Yard>
        • sldprt

          object
          optional
          Object Properties
        • step

          object
          optional
          Object Properties
        • stl

          object
          optional
          Object Properties
          • coords

            object
            optional
            Object Properties
            • forward

              object
              optional
              Object Properties
              • axis

                string
                optional
                Possible values
                • y:  'Y' axis.
                • z:  'Z' axis.
              • direction

                string
                optional
                Possible values
                • positive:  Increasing numbers.
                • negative:  Decreasing numbers.
            • up

              object
              optional
              Object Properties
              • axis

                string
                optional
                Possible values
                • y:  'Y' axis.
                • z:  'Z' axis.
              • direction

                string
                optional
                Possible values
                • positive:  Increasing numbers.
                • negative:  Decreasing numbers.
          • type

            string
            optional
            Possible values
            • stl
          • units

            string
            optional
            Possible values
            • cm:  Centimeters <https://en.wikipedia.org/wiki/Centimeter>
            • ft:  Feet <https://en.wikipedia.org/wiki/Foot_(unit)>
            • in:  Inches <https://en.wikipedia.org/wiki/Inch>
            • m:  Meters <https://en.wikipedia.org/wiki/Meter>
            • mm:  Millimeters <https://en.wikipedia.org/wiki/Millimeter>
            • yd:  Yards <https://en.wikipedia.org/wiki/Yard>
      • started_at

        string / ISO-8601
        optional
      • status

        string
        optional
        Possible values
        • queued:  The async API call is queued.
        • uploaded:  The async API call was uploaded to be converted.
        • in_progress:  The async API call is in progress.
        • completed:  The async API call has completed.
        • failed:  The async API call has failed.
      • type

        string
        optional
        Possible values
        • file_conversion
      • updated_at

        string / ISO-8601
        optional
      • user_id

        string / UUID
        optional
    • file_center_of_mass

      object
      optional
      Object Properties
      • center_of_mass

        object
        optional
        Object Properties
        • x

          number
          optional
        • y

          number
          optional
        • z

          number
          optional
      • completed_at

        string / ISO-8601
        optional
      • created_at

        string / ISO-8601
        optional
      • error

        string
        optional
      • id

        string / UUID
        optional
      • output_unit

        string
        optional
        Possible values
        • cm:  Centimeters <https://en.wikipedia.org/wiki/Centimeter>
        • ft:  Feet <https://en.wikipedia.org/wiki/Foot_(unit)>
        • in:  Inches <https://en.wikipedia.org/wiki/Inch>
        • m:  Meters <https://en.wikipedia.org/wiki/Meter>
        • mm:  Millimeters <https://en.wikipedia.org/wiki/Millimeter>
        • yd:  Yards <https://en.wikipedia.org/wiki/Yard>
      • src_format

        string
        optional
        Possible values
        • fbx:  Autodesk Filmbox (FBX) format. <https://en.wikipedia.org/wiki/FBX>
        • gltf:  glTF 2.0.
        • obj:  The OBJ file format. <https://en.wikipedia.org/wiki/Wavefront_.obj_file> It may or may not have an an attached material (mtl // mtllib) within the file, but we interact with it as if it does not.
        • ply:  The PLY file format. <https://en.wikipedia.org/wiki/PLY_(file_format)>
        • sldprt:  SolidWorks part (SLDPRT) format.
        • step:  The STEP file format. <https://en.wikipedia.org/wiki/ISO_10303-21>
        • stl:  The STL file format. <https://en.wikipedia.org/wiki/STL_(file_format)>
      • started_at

        string / ISO-8601
        optional
      • status

        string
        optional
        Possible values
        • queued:  The async API call is queued.
        • uploaded:  The async API call was uploaded to be converted.
        • in_progress:  The async API call is in progress.
        • completed:  The async API call has completed.
        • failed:  The async API call has failed.
      • type

        string
        optional
        Possible values
        • file_center_of_mass
      • updated_at

        string / ISO-8601
        optional
      • user_id

        string / UUID
        optional
    • file_mass

      object
      optional
      Object Properties
      • completed_at

        string / ISO-8601
        optional
      • created_at

        string / ISO-8601
        optional
      • error

        string
        optional
      • id

        string / UUID
        optional
      • mass

        number
        optional
      • material_density

        number
        optional
      • material_density_unit

        string
        optional
        Possible values
        • lb:ft3:  Pounds per cubic feet.
        • kg:m3:  Kilograms per cubic meter.
      • output_unit

        string
        optional
        Possible values
        • g:  Grams <https://en.wikipedia.org/wiki/Gram>
        • kg:  Kilograms <https://en.wikipedia.org/wiki/Kilogram>
        • lb:  Pounds <https://en.wikipedia.org/wiki/Pound_(mass)>
      • src_format

        string
        optional
        Possible values
        • fbx:  Autodesk Filmbox (FBX) format. <https://en.wikipedia.org/wiki/FBX>
        • gltf:  glTF 2.0.
        • obj:  The OBJ file format. <https://en.wikipedia.org/wiki/Wavefront_.obj_file> It may or may not have an an attached material (mtl // mtllib) within the file, but we interact with it as if it does not.
        • ply:  The PLY file format. <https://en.wikipedia.org/wiki/PLY_(file_format)>
        • sldprt:  SolidWorks part (SLDPRT) format.
        • step:  The STEP file format. <https://en.wikipedia.org/wiki/ISO_10303-21>
        • stl:  The STL file format. <https://en.wikipedia.org/wiki/STL_(file_format)>
      • started_at

        string / ISO-8601
        optional
      • status

        string
        optional
        Possible values
        • queued:  The async API call is queued.
        • uploaded:  The async API call was uploaded to be converted.
        • in_progress:  The async API call is in progress.
        • completed:  The async API call has completed.
        • failed:  The async API call has failed.
      • type

        string
        optional
        Possible values
        • file_mass
      • updated_at

        string / ISO-8601
        optional
      • user_id

        string / UUID
        optional
    • file_volume

      object
      optional
      Object Properties
      • completed_at

        string / ISO-8601
        optional
      • created_at

        string / ISO-8601
        optional
      • error

        string
        optional
      • id

        string / UUID
        optional
      • output_unit

        string
        optional
        Possible values
        • cm3:  Cubic centimeters (cc or cm³) <https://en.wikipedia.org/wiki/Cubic_centimeter>
        • ft3:  Cubic feet (ft³) <https://en.wikipedia.org/wiki/Cubic_foot>
        • in3:  Cubic inches (cu in or in³) <https://en.wikipedia.org/wiki/Cubic_inch>
        • m3:  Cubic meters (m³) <https://en.wikipedia.org/wiki/Cubic_meter>
        • yd3:  Cubic yards (yd³) <https://en.wikipedia.org/wiki/Cubic_yard>
        • usfloz:  US Fluid Ounces (fl oz) <https://en.wikipedia.org/wiki/Fluid_ounce>
        • usgal:  US Gallons (gal US) <https://en.wikipedia.org/wiki/Gallon>
        • l:  Liters (l) <https://en.wikipedia.org/wiki/Litre>
        • ml:  Milliliters (ml) <https://en.wikipedia.org/wiki/Litre>
      • src_format

        string
        optional
        Possible values
        • fbx:  Autodesk Filmbox (FBX) format. <https://en.wikipedia.org/wiki/FBX>
        • gltf:  glTF 2.0.
        • obj:  The OBJ file format. <https://en.wikipedia.org/wiki/Wavefront_.obj_file> It may or may not have an an attached material (mtl // mtllib) within the file, but we interact with it as if it does not.
        • ply:  The PLY file format. <https://en.wikipedia.org/wiki/PLY_(file_format)>
        • sldprt:  SolidWorks part (SLDPRT) format.
        • step:  The STEP file format. <https://en.wikipedia.org/wiki/ISO_10303-21>
        • stl:  The STL file format. <https://en.wikipedia.org/wiki/STL_(file_format)>
      • started_at

        string / ISO-8601
        optional
      • status

        string
        optional
        Possible values
        • queued:  The async API call is queued.
        • uploaded:  The async API call was uploaded to be converted.
        • in_progress:  The async API call is in progress.
        • completed:  The async API call has completed.
        • failed:  The async API call has failed.
      • type

        string
        optional
        Possible values
        • file_volume
      • updated_at

        string / ISO-8601
        optional
      • user_id

        string / UUID
        optional
      • volume

        number
        optional
    • file_density

      object
      optional
      Object Properties
      • completed_at

        string / ISO-8601
        optional
      • created_at

        string / ISO-8601
        optional
      • density

        number
        optional
      • error

        string
        optional
      • id

        string / UUID
        optional
      • material_mass

        number
        optional
      • material_mass_unit

        string
        optional
        Possible values
        • g:  Grams <https://en.wikipedia.org/wiki/Gram>
        • kg:  Kilograms <https://en.wikipedia.org/wiki/Kilogram>
        • lb:  Pounds <https://en.wikipedia.org/wiki/Pound_(mass)>
      • output_unit

        string
        optional
        Possible values
        • lb:ft3:  Pounds per cubic feet.
        • kg:m3:  Kilograms per cubic meter.
      • src_format

        string
        optional
        Possible values
        • fbx:  Autodesk Filmbox (FBX) format. <https://en.wikipedia.org/wiki/FBX>
        • gltf:  glTF 2.0.
        • obj:  The OBJ file format. <https://en.wikipedia.org/wiki/Wavefront_.obj_file> It may or may not have an an attached material (mtl // mtllib) within the file, but we interact with it as if it does not.
        • ply:  The PLY file format. <https://en.wikipedia.org/wiki/PLY_(file_format)>
        • sldprt:  SolidWorks part (SLDPRT) format.
        • step:  The STEP file format. <https://en.wikipedia.org/wiki/ISO_10303-21>
        • stl:  The STL file format. <https://en.wikipedia.org/wiki/STL_(file_format)>
      • started_at

        string / ISO-8601
        optional
      • status

        string
        optional
        Possible values
        • queued:  The async API call is queued.
        • uploaded:  The async API call was uploaded to be converted.
        • in_progress:  The async API call is in progress.
        • completed:  The async API call has completed.
        • failed:  The async API call has failed.
      • type

        string
        optional
        Possible values
        • file_density
      • updated_at

        string / ISO-8601
        optional
      • user_id

        string / UUID
        optional
    • file_surface_area

      object
      optional
      Object Properties
      • completed_at

        string / ISO-8601
        optional
      • created_at

        string / ISO-8601
        optional
      • error

        string
        optional
      • id

        string / UUID
        optional
      • output_unit

        string
        optional
        Possible values
        • cm2:  Square centimeters <https://en.wikipedia.org/wiki/Square_centimeter>
        • dm2:  Square decimeters <https://en.wikipedia.org/wiki/Square_decimeter>
        • ft2:  Square feet <https://en.wikipedia.org/wiki/Square_foot>
        • in2:  Square inches <https://en.wikipedia.org/wiki/Square_inch>
        • km2:  Square kilometers <https://en.wikipedia.org/wiki/Square_kilometer>
        • m2:  Square meters <https://en.wikipedia.org/wiki/Square_meter>
        • mm2:  Square millimeters <https://en.wikipedia.org/wiki/Square_millimeter>
        • yd2:  Square yards <https://en.wikipedia.org/wiki/Square_mile>
      • src_format

        string
        optional
        Possible values
        • fbx:  Autodesk Filmbox (FBX) format. <https://en.wikipedia.org/wiki/FBX>
        • gltf:  glTF 2.0.
        • obj:  The OBJ file format. <https://en.wikipedia.org/wiki/Wavefront_.obj_file> It may or may not have an an attached material (mtl // mtllib) within the file, but we interact with it as if it does not.
        • ply:  The PLY file format. <https://en.wikipedia.org/wiki/PLY_(file_format)>
        • sldprt:  SolidWorks part (SLDPRT) format.
        • step:  The STEP file format. <https://en.wikipedia.org/wiki/ISO_10303-21>
        • stl:  The STL file format. <https://en.wikipedia.org/wiki/STL_(file_format)>
      • started_at

        string / ISO-8601
        optional
      • status

        string
        optional
        Possible values
        • queued:  The async API call is queued.
        • uploaded:  The async API call was uploaded to be converted.
        • in_progress:  The async API call is in progress.
        • completed:  The async API call has completed.
        • failed:  The async API call has failed.
      • surface_area

        number
        optional
      • type

        string
        optional
        Possible values
        • file_surface_area
      • updated_at

        string / ISO-8601
        optional
      • user_id

        string / UUID
        optional
    • text_to_cad

      object
      optional
      Object Properties
      • code

        string
        optional
      • completed_at

        string / ISO-8601
        optional
      • created_at

        string / ISO-8601
        optional
      • error

        string
        optional
      • feedback

        string
        optional
        Possible values
        • thumbs_up:  Thumbs up.
        • thumbs_down:  Thumbs down.
        • accepted:  Accepted.
        • rejected:  Rejected.
      • id

        string / UUID
        optional
      • model

        string
        optional
        Possible values
        • cad:  CAD.
        • kcl:  KCL.
        • kcl_iteration:  KCL iteration.
      • model_version

        string
        optional
      • output_format

        string
        optional
        Possible values
        • fbx:  Autodesk Filmbox (FBX) format. <https://en.wikipedia.org/wiki/FBX>
        • glb:  Binary glTF 2.0. This is a single binary with .glb extension. This is better if you want a compressed format as opposed to the human readable glTF that lacks compression.
        • gltf:  glTF 2.0. Embedded glTF 2.0 (pretty printed). Single JSON file with .gltf extension binary data encoded as base64 data URIs. The JSON contents are pretty printed. It is human readable, single file, and you can view the diff easily in a git commit.
        • obj:  The OBJ file format. <https://en.wikipedia.org/wiki/Wavefront_.obj_file> It may or may not have an an attached material (mtl // mtllib) within the file, but we interact with it as if it does not.
        • ply:  The PLY file format. <https://en.wikipedia.org/wiki/PLY_(file_format)>
        • step:  The STEP file format. <https://en.wikipedia.org/wiki/ISO_10303-21>
        • stl:  The STL file format. <https://en.wikipedia.org/wiki/STL_(file_format)>
      • outputs

        object
        optional
      • prompt

        string
        optional
      • started_at

        string / ISO-8601
        optional
      • status

        string
        optional
        Possible values
        • queued:  The async API call is queued.
        • uploaded:  The async API call was uploaded to be converted.
        • in_progress:  The async API call is in progress.
        • completed:  The async API call has completed.
        • failed:  The async API call has failed.
      • type

        string
        optional
        Possible values
        • text_to_cad
      • updated_at

        string / ISO-8601
        optional
      • user_id

        string / UUID
        optional
    • text_to_cad_iteration

      object
      optional
      Object Properties
      • code

        string
        optional
      • completed_at

        string / ISO-8601
        optional
      • created_at

        string / ISO-8601
        optional
      • error

        string
        optional
      • feedback

        string
        optional
        Possible values
        • thumbs_up:  Thumbs up.
        • thumbs_down:  Thumbs down.
        • accepted:  Accepted.
        • rejected:  Rejected.
      • id

        string / UUID
        optional
      • model

        string
        optional
        Possible values
        • cad:  CAD.
        • kcl:  KCL.
        • kcl_iteration:  KCL iteration.
      • model_version

        string
        optional
      • original_source_code

        string
        optional
      • prompt

        string
        optional
      • source_ranges

        array
        optional
        Array of
        • prompt

          string
          optional
        • range

          object
          optional
          Object Properties
          • end

            object
            optional
            Object Properties
          • start

            object
            optional
            Object Properties
      • started_at

        string / ISO-8601
        optional
      • status

        string
        optional
        Possible values
        • queued:  The async API call is queued.
        • uploaded:  The async API call was uploaded to be converted.
        • in_progress:  The async API call is in progress.
        • completed:  The async API call has completed.
        • failed:  The async API call has failed.
      • type

        string
        optional
        Possible values
        • text_to_cad_iteration
      • updated_at

        string / ISO-8601
        optional
      • user_id

        string / UUID
        optional
get
/async/operations/{id}
$ curl "https://api.zoo.dev/async/operations/{id}" \
	--header "Authorization: Bearer $TOKEN"
200 OK
Response
{
  "completed_at": "2024-12-19T17:48:57.799Z",
  "created_at": "2024-12-19T17:48:57.799Z",
  "error": "hVU7Txqn4wzfNf7lJLsCaJ8o8GxWjf",
  "id": "81334764-33a1-47a4-9ef7-440c12530d33",
  "mass": 11,
  "material_density": 11,
  "material_density_unit": "lb:ft3",
  "output_unit": "g",
  "src_format": "ply",
  "started_at": "2024-12-19T17:48:57.799Z",
  "status": "failed",
  "type": "file_mass",
  "updated_at": "2024-12-19T17:48:57.799Z",
  "user_id": "a9627f28-2ad5-4299-b86b-3db9a0beb0d0"
}