Skip to content
Stella ConnectDocs
Parts

Import one or more part files

POST{baseUrl}/v1.0/parts/import

Parts are the portable, singular geometry units for use within the Stella Connect ecosystem.

You'll need these if you want to perform a Nest, for example. If you use a file that has multiple parts (separate closed contours) we will attempt to extract all of the individual parts contained within that file.

File types supported: - DXF - DWG - STEP - IGES - SLDPRT - SLDASM - SLDDRW - ZIP

Authx-api-key

multipart/form-data
Field
Type
Required
files[]file[]Yes

Status
When
200

Success

400

Bad Request

401

Unauthorized

413

The upload exceeded the maximum request body size.

500

An unexpected error occurred on the server.

Field
Type
Required
Description
files[]object[]No

Collection of imported file results

files[].measurementSystemstringNo

Measurement system used (e.g., "metric", "imperial")

files[].measurementUnitstringNo

Unit of measurement for dimensions (e.g., "mm", "in")

files[].namestringNo

Original filename of the imported file

files[].parts[]object[]No

Collection of parts extracted from this file

files[].parts[].iduuidNo

Unique identifier for the part

files[].parts[].areanumberNo

True surface area of the part in the file's measurement units

files[].parts[].contoursintegerNo

Number of contour profiles in the part geometry

files[].parts[].depthnumberNo

Depth dimension of the part

files[].parts[].lengthnumberNo

Length dimension of the part

files[].parts[].measurementSystemstringNo

Measurement system used for this part's dimensions

files[].parts[].measurementUnitstringNo

Unit of measurement for this part's dimensions

files[].parts[].namestringNo

Name of the part within the file

files[].parts[].outsideAreanumberNo

Outside boundary area of the part

files[].parts[].perimeternumberNo

Total perimeter length of the part profile

files[].parts[].rectangularAreanumberNo

Bounding-box area of the part (length × width)

files[].parts[].widthnumberNo

Width dimension of the part

files[].parts[].imagestringNo

Deprecated. Please use /parts/{partId}/rendering endpoint to get part images.

files[].imagestringNo

Deprecated. Please use /parts/{partId}/rendering endpoint to get part images.

Example 200 response
{
  "files": [
    {
      "measurementSystem": "string",
      "measurementUnit": "string",
      "name": "string",
      "parts": [
        {
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "area": 0.1,
          "contours": 0,
          "depth": 0.1,
          "length": 0.1,
          "measurementSystem": "string",
          "measurementUnit": "string",
          "name": "string",
          "outsideArea": 0.1,
          "perimeter": 0.1,
          "rectangularArea": 0.1,
          "width": 0.1,
          "image": "string"
        }
      ],
      "image": "string"
    }
  ]
}