Import one or more 3D CAD files as parts
Uploads one or more 3D CAD files and extracts every part contained in them.
Each extracted part is assigned a stable PartId that downstream endpoints
(classification, nesting, rendering) require.
Supported file types
- STEP
- IGES
- SLDPRT
- SLDASM
- SLDDRW
- ZIP
x-api-keymultipart/form-dataField | Type | Required | Description |
|---|---|---|---|
| files[] | file[] | Yes | One or more CAD files to import. See the endpoint description for supported formats. A single file may contain multiple parts; separate closed contours are extracted as distinct parts. |
| unfold | boolean | No | When |
Status | When |
|---|---|
| 200 | Success |
| 400 | Bad Request |
| 401 | Unauthorized |
| 403 | Forbidden |
| 413 | The upload exceeded the maximum request body size. |
| 500 | An unexpected error occurred on the server. |
Field | Type | Required | Description |
|---|---|---|---|
| data | object | null | No | Response payload for the file-import endpoints. Returned inside a
|
| data. | object[] | No | One entry per uploaded file, in the order the files were received. |
| data. | uuid | No | Stable identifier for the imported file. Persist this to reference the file in subsequent calls. |
| data. | string | No | Original file name as supplied at upload time. |
| data. | object[] | No | Every part extracted from the file. A file with a single closed contour yields one entry; multi-body files yield one entry per body. |
| data. | uuid | No | Stable identifier for the extracted part. Required by classification, nesting and rendering endpoints. |
| data. | string | No | Part name derived from the CAD file, or a synthesized default when the file does not name the part. |
| errors[] | object[] | null | No | One or more errors describing why the request failed. Absent ( |
| errors[]. | string | null | No | Human-readable explanation of the error. Intended for display to end users or logs. Wording is not stable and should not be branched on. |
| errors[]. | string | null | No | Machine-readable, stable error identifier. Consumers should branch on this value
rather than on Description. See |
| paging | object | null | No | Paging metadata for list endpoints. Absent on single-item responses. |
| paging. | integer | No | |
| paging. | integer | No | |
| paging. | integer | No |
{
"data": {
"files": [
{
"fileId": "a1c6a2ab-4b01-4253-b4c9-70e04b3b48fc",
"name": "string",
"parts": [
{
"partId": "08fcc2e5-7760-493b-b8f1-1ad26fcb0a9e",
"name": "string"
}
]
}
]
},
"errors": [
{
"description": "string",
"errorId": "string"
}
],
"paging": {
"limit": 0,
"start": 0,
"total": 0
}
}