{
  "openapi": "3.1.1",
  "info": {
    "title": "Connect",
    "version": "v2.0"
  },
  "paths": {
    "/v2.0/2d/files/import": {
      "post": {
        "tags": [
          "files"
        ],
        "summary": "Import one or more 2D CAD files as parts",
        "description": "Uploads one or more 2D CAD files and extracts every part contained in them.\nEach extracted part is assigned a stable `PartId` that downstream endpoints\n(classification, nesting, rendering) require.\n\n## Supported file types\n- DXF\n- DWG",
        "operationId": "ImportFiles2D",
        "requestBody": {
          "description": "",
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/ImportFilesRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeOfImportFilesResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "413": {
            "description": "The upload exceeded the maximum request body size.",
            "content": {
              "application/json": {
                "schema": {
                  "nullable": true,
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred on the server.",
            "content": {
              "application/json": {
                "schema": {
                  "nullable": true,
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          }
        },
        "security": [
          {
            "apikey": []
          }
        ]
      }
    },
    "/v2.0/2d/files/{FileId}/rendering": {
      "get": {
        "tags": [
          "files"
        ],
        "summary": "Render an imported 2D CAD file as an image",
        "description": "Renders an imported 2D file to a PNG or SVG image, returned as a\nbase64-encoded string. Get a `FileId` by uploading a file [here](#/files/ImportFiles2D).",
        "operationId": "RenderFile2D",
        "parameters": [
          {
            "name": "FileId",
            "in": "path",
            "required": true,
            "description": "Identifier of the imported file to render.",
            "schema": {
              "type": "string",
              "format": "guid"
            }
          },
          {
            "name": "ImageType",
            "in": "query",
            "description": "Output image format. Default: `Png`.",
            "schema": {
              "nullable": true,
              "allOf": [
                {
                  "$ref": "#/components/schemas/ImageTypeRequest"
                }
              ]
            }
          },
          {
            "name": "ImageWidth",
            "in": "query",
            "description": "Width of the rendered image in pixels. Must be greater than 0. Default: `400`.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "nullable": true
            }
          },
          {
            "name": "ImageHeight",
            "in": "query",
            "description": "Height of the rendered image in pixels. Must be greater than 0. Default: `400`.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "nullable": true
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeOfRenderFileResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred on the server.",
            "content": {
              "application/json": {
                "schema": {
                  "nullable": true,
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          }
        },
        "security": [
          {
            "apikey": []
          }
        ]
      }
    },
    "/v2.0/2d/parts/nesting/planar": {
      "post": {
        "tags": [
          "parts"
        ],
        "summary": "Nest one or more planar parts onto sheet stock",
        "description": "Nests one or more classified planar (sheet-metal) parts onto candidate\nsheet stock and returns per-sheet layout usage plus per-part weights.\nGet a `PartId` by uploading a file\n[here](#/files/ImportFiles2D) — every imported file yields one or more\nparts. The returned `NestingId` can be passed to\n[RenderPlanarNest2D](#/parts/RenderPlanarNest2D) to produce an image\nof the layout.\n\nThe weight unit is always pounds.\n\nParts must be flat. To nest a 3D sheet-metal file (STEP), import it through\n[ImportFiles3D](#/files/ImportFiles3D) with `Unfold=true` and use that part id;\nthe 2D importer does not flatten 3D geometry.\n\nErrors: `part_not_found` (404) when a `PartId` was never imported,\n`part_not_nestable` (422) when a part is not flat or has no outline that can be\nplaced on a sheet, `nesting_failed` (500) for any other upstream failure.",
        "operationId": "PlanarPartsNesting2D",
        "requestBody": {
          "description": "",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PlanarNestingRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeOfPlanarNestingOutputResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "A PartId does not match any imported part.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeOfPlanarNestingOutputResponse"
                }
              }
            }
          },
          "422": {
            "description": "A part is not flat, or has no outline that can be placed on a sheet.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeOfPlanarNestingOutputResponse"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred on the server.",
            "content": {
              "application/json": {
                "schema": {
                  "nullable": true,
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          }
        },
        "security": [
          {
            "apikey": []
          }
        ]
      }
    },
    "/v2.0/2d/parts/nesting/{NestId}/sheets/{SheetId}/rendering/planar": {
      "post": {
        "tags": [
          "parts"
        ],
        "summary": "Render a planar nesting as an image per sheet",
        "description": "Renders a previously computed planar nesting to a PNG image per sheet,\neach returned as a base64-encoded string. Get a `NestId` by calling\n[PlanarPartsNesting2D](#/parts/PlanarPartsNesting2D) — the returned\n`NestingId` is what to pass here.",
        "operationId": "RenderPlanarNest2D",
        "parameters": [
          {
            "name": "NestId",
            "in": "path",
            "required": true,
            "description": "Path parameter. The `NestingId` returned by\n`PlanarPartsNesting2D`.",
            "schema": {
              "type": "string",
              "format": "guid"
            }
          },
          {
            "name": "SheetId",
            "in": "path",
            "required": true,
            "description": "Path parameter. Reserved for future per-sheet filtering. Currently\nignored — every sheet in the nest is returned regardless of the value\nsupplied. Retained in the URL for forward compatibility.",
            "schema": {
              "type": "string",
              "format": "guid"
            }
          }
        ],
        "requestBody": {
          "description": "",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RenderPlanarNestRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeOfRenderPlanarNestResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "500": {
            "description": "An unexpected error occurred on the server.",
            "content": {
              "application/json": {
                "schema": {
                  "nullable": true,
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          }
        },
        "security": [
          {
            "apikey": []
          }
        ]
      }
    },
    "/v2.0/2d/parts/{PartId}/classification/planar": {
      "get": {
        "tags": [
          "parts"
        ],
        "summary": "Classify an imported 2D part as a planar (sheet-metal) blank",
        "description": "Classifies an imported 2D part as a planar sheet-metal blank and returns\nits measured dimensions (flat-pattern length, width, cut path, hole\ncounts, and volume). Get a `PartId` by uploading a file\n[here](#/files/ImportFiles2D) — every imported file yields one or more parts.\n\nTo classify a 3D sheet-metal file (STEP), import it through\n[ImportFiles3D](#/files/ImportFiles3D) with `Unfold=true` and pass that part id here.",
        "operationId": "PlanarPartsClassification2D",
        "parameters": [
          {
            "name": "PartId",
            "in": "path",
            "required": true,
            "description": "Identifier of the imported part to classify.",
            "schema": {
              "type": "string",
              "format": "guid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeOfPlanarPartsClassification2DResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred on the server.",
            "content": {
              "application/json": {
                "schema": {
                  "nullable": true,
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          }
        },
        "security": [
          {
            "apikey": []
          }
        ]
      }
    },
    "/v2.0/2d/parts/{PartId}/rendering": {
      "get": {
        "tags": [
          "parts"
        ],
        "summary": "Render an imported 2D part as an image",
        "description": "Renders an imported 2D part to a PNG or SVG image, returned as a\nbase64-encoded string. Get a `PartId` by uploading a file [here](#/files/ImportFiles2D)\n— every imported file yields one or more parts.",
        "operationId": "RenderPart2D",
        "parameters": [
          {
            "name": "PartId",
            "in": "path",
            "required": true,
            "description": "Identifier of the imported part to render.",
            "schema": {
              "type": "string",
              "format": "guid"
            }
          },
          {
            "name": "ImageType",
            "in": "query",
            "description": "Output image format. Default: `Png`.",
            "schema": {
              "nullable": true,
              "allOf": [
                {
                  "$ref": "#/components/schemas/ImageTypeRequest"
                }
              ]
            }
          },
          {
            "name": "ImageWidth",
            "in": "query",
            "description": "Width of the rendered image in pixels. Must be greater than 0. Default: `400`.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "nullable": true
            }
          },
          {
            "name": "ImageHeight",
            "in": "query",
            "description": "Height of the rendered image in pixels. Must be greater than 0. Default: `400`.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "nullable": true
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeOfRenderPartResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred on the server.",
            "content": {
              "application/json": {
                "schema": {
                  "nullable": true,
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          }
        },
        "security": [
          {
            "apikey": []
          }
        ]
      }
    },
    "/v2.0/3d/files/import": {
      "post": {
        "tags": [
          "files"
        ],
        "summary": "Import one or more 3D CAD files as parts",
        "description": "Uploads one or more 3D CAD files and extracts every part contained in them.\nEach extracted part is assigned a stable `PartId` that downstream endpoints\n(classification, nesting, rendering) require.\n\n## Supported file types\n- STEP\n- IGES\n- SLDPRT\n- SLDASM\n- SLDDRW\n- ZIP",
        "operationId": "ImportFiles3D",
        "requestBody": {
          "description": "",
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/ImportFiles3DRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeOfImportFilesResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "413": {
            "description": "The upload exceeded the maximum request body size.",
            "content": {
              "application/json": {
                "schema": {
                  "nullable": true,
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred on the server.",
            "content": {
              "application/json": {
                "schema": {
                  "nullable": true,
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          }
        },
        "security": [
          {
            "apikey": []
          }
        ]
      }
    },
    "/v2.0/3d/files/{FileId}/rendering": {
      "get": {
        "tags": [
          "files"
        ],
        "summary": "Render an imported 3D CAD file as an image",
        "description": "Renders an imported 3D file to a PNG or SVG image, returned as a\nbase64-encoded string. Get a `FileId` by uploading a file [here](#/files/ImportFiles3D).",
        "operationId": "RenderFile3D",
        "parameters": [
          {
            "name": "FileId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "guid"
            }
          },
          {
            "name": "ImageType",
            "in": "query",
            "schema": {
              "nullable": true,
              "allOf": [
                {
                  "$ref": "#/components/schemas/ImageTypeRequest"
                }
              ]
            }
          },
          {
            "name": "ImageWidth",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "nullable": true
            }
          },
          {
            "name": "ImageHeight",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "nullable": true
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeOfRenderFileResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred on the server.",
            "content": {
              "application/json": {
                "schema": {
                  "nullable": true,
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          }
        },
        "security": [
          {
            "apikey": []
          }
        ]
      }
    },
    "/v2.0/3d/parts/nesting/linear": {
      "post": {
        "tags": [
          "parts"
        ],
        "summary": "Nest linear parts onto stock bars",
        "description": "Solves a 1D bin-packing problem: given a set of part cut-lengths and a set\nof raw-stock bar lengths, decides how many bars are needed and which parts\nland on each bar, minimizing waste. Applies saw allowances (chuck at bar\nstart, kerf per cut) and a per-stock remnant policy that governs whether\nleftover pieces are returned to inventory or billed as scrap.\n\n## Notes\n- Response `PartId` values echo the caller-supplied `Parts[].PartId` from\n  the request when provided, otherwise a server-generated id. The id is\n  an opaque correlation token — nothing on the server resolves it against\n  a stored part. `StockId` values are always server-generated.\n- `TotalNestedLength` / `TotalNestedWeight` are proportional shares of the\n  total stock consumed, allocated by each part's summed length. They include\n  kerf + chuck; they are **not** simply `Length × TotalItemsNested`.\n- `StockLayoutResponse.Parts[].Quantity` and `NumberOfPartsPerUnit` are\n  **per single bar**; multiply by `NumberOfUnits` for the aggregate count.",
        "operationId": "LinearPartsNesting3D",
        "requestBody": {
          "description": "",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LinearNestingRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeOfLinearNestingOutputResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "500": {
            "description": "An unexpected error occurred on the server.",
            "content": {
              "application/json": {
                "schema": {
                  "nullable": true,
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          }
        },
        "security": [
          {
            "apikey": []
          }
        ]
      }
    },
    "/v2.0/3d/parts/nesting/linear/lookup": {
      "post": {
        "tags": [
          "parts"
        ],
        "summary": "Nest linear parts by PartId onto stock bars",
        "description": "Same 1D bin-packing solve as the standard linear-nesting endpoint, but each\npart is identified by `PartId` (a previously imported part) instead of by\nan explicit length. Each part is classified inline and uses the\nresulting cut length. Applies saw allowances (chuck, kerf) and a per-stock\nremnant policy.\n\n`Parts[].PartId` in the response echoes the caller-supplied part ids (unlike the standard nesting endpoint where ids are server-generated).",
        "operationId": "LinearPartsPartLookupNesting3D",
        "requestBody": {
          "description": "",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LinearNestingPartLookupRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeOfLinearNestingOutputResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred on the server.",
            "content": {
              "application/json": {
                "schema": {
                  "nullable": true,
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          }
        },
        "security": [
          {
            "apikey": []
          }
        ]
      }
    },
    "/v2.0/3d/parts/nesting/{NestId}/rendering/linear": {
      "post": {
        "tags": [
          "parts"
        ],
        "summary": "Render a linear nesting as an image",
        "description": "Renders a previously computed linear nesting to a PNG or SVG image,\nreturned as a base64-encoded string. Get a `NestId` by calling\n[LinearPartsNesting3D](#/parts/LinearPartsNesting3D) or\n[LinearPartsPartLookupNesting3D](#/parts/LinearPartsPartLookupNesting3D) —\nthe returned `NestingId` is what to pass here.",
        "operationId": "RenderLinearNest3D",
        "parameters": [
          {
            "name": "NestId",
            "in": "path",
            "required": true,
            "description": "Identifier of the nesting to render — the `NestingId` returned by\nthe linear-nesting endpoints.",
            "schema": {
              "type": "string",
              "format": "guid"
            }
          }
        ],
        "requestBody": {
          "description": "",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RenderLinearNestRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeOfRenderLinearNestResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred on the server.",
            "content": {
              "application/json": {
                "schema": {
                  "nullable": true,
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          }
        },
        "security": [
          {
            "apikey": []
          }
        ]
      }
    },
    "/v2.0/3d/parts/{PartId}/classification/linear": {
      "get": {
        "tags": [
          "parts"
        ],
        "summary": "Classify an imported 3D part as linear stock",
        "description": "Classifies an imported 3D part as a linear stock item — a bar, tube,\nstructural shape, or pipe — and returns its family, sub-type, and measured\ndimensions (length, cross-section, surface areas, volume). Get a `PartId`\nby uploading a file [here](#/files/ImportFiles3D) — every imported file\nyields one or more parts.",
        "operationId": "LinearPartsClassification3D",
        "parameters": [
          {
            "name": "PartId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "guid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeOfLinearPartsClassificationResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred on the server.",
            "content": {
              "application/json": {
                "schema": {
                  "nullable": true,
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          }
        },
        "security": [
          {
            "apikey": []
          }
        ]
      }
    },
    "/v2.0/3d/parts/{PartId}/rendering": {
      "get": {
        "tags": [
          "parts"
        ],
        "summary": "Render an imported 3D part as an image",
        "description": "Renders an imported 3D part to a PNG or SVG image, returned as a\nbase64-encoded string. Get a `PartId` by uploading a file [here](#/files/ImportFiles3D)\n— every imported file yields one or more parts.",
        "operationId": "RenderPart3D",
        "parameters": [
          {
            "name": "PartId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "guid"
            }
          },
          {
            "name": "ImageType",
            "in": "query",
            "schema": {
              "nullable": true,
              "allOf": [
                {
                  "$ref": "#/components/schemas/ImageTypeRequest"
                }
              ]
            }
          },
          {
            "name": "ImageWidth",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "nullable": true
            }
          },
          {
            "name": "ImageHeight",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "nullable": true
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeOfRenderPartResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred on the server.",
            "content": {
              "application/json": {
                "schema": {
                  "nullable": true,
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          }
        },
        "security": [
          {
            "apikey": []
          }
        ]
      }
    },
    "/v2.0/commerce/orders": {
      "get": {
        "tags": [
          "commerce"
        ],
        "summary": "List completed orders",
        "description": "Returns a paginated list of completed orders.\nSupersedes v1/commerce/orders with a richer schema including pricing totals, miscellaneous charges,\nshipping method, and a structured customer block.",
        "operationId": "ListOrdersV2",
        "parameters": [
          {
            "name": "StartTime",
            "in": "query",
            "description": "Return orders placed after this UTC date/time.",
            "schema": {
              "type": "string",
              "format": "date-time",
              "nullable": true
            }
          },
          {
            "name": "Limit",
            "in": "query",
            "description": "The page size of results to return.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 50,
              "maximum": 250,
              "minimum": 1,
              "nullable": true
            }
          },
          {
            "name": "Start",
            "in": "query",
            "description": "The page number to start the results from.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1,
              "minimum": 1,
              "nullable": true
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeOfIEnumerableOfOrder"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "500": {
            "description": "An unexpected error occurred on the server.",
            "content": {
              "application/json": {
                "schema": {
                  "nullable": true,
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          }
        },
        "security": [
          {
            "apikey": []
          }
        ]
      }
    },
    "/v2.0/commerce/product-costs/{CompanyLocationKey}": {
      "put": {
        "tags": [
          "commerce"
        ],
        "summary": "Updates product costs",
        "description": "Updates product costs for multiple products in a single batch request.",
        "operationId": "UpdateProductCostsV2",
        "parameters": [
          {
            "name": "CompanyLocationKey",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "guid"
            }
          }
        ],
        "requestBody": {
          "description": "",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateProductCostsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          },
          "422": {
            "description": "If any SupplierProductId is not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred on the server.",
            "content": {
              "application/json": {
                "schema": {
                  "nullable": true,
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          }
        },
        "security": [
          {
            "apikey": []
          }
        ]
      }
    },
    "/v2.0/commerce/product-limits/{CompanyLocationKey}": {
      "put": {
        "tags": [
          "commerce"
        ],
        "summary": "Updates product limits",
        "description": "Updates product limits for multiple products in a single batch request",
        "operationId": "UpdateProductLimitsV2",
        "parameters": [
          {
            "name": "CompanyLocationKey",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "guid"
            }
          }
        ],
        "requestBody": {
          "description": "",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateProductLimitsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          },
          "422": {
            "description": "If any SupplierProductId is not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred on the server.",
            "content": {
              "application/json": {
                "schema": {
                  "nullable": true,
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          }
        },
        "security": [
          {
            "apikey": []
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "ConnectEnvelopeObjectResult": {
        "type": "object",
        "description": "Non-generic base of ConnectEnvelope`1. Used by endpoints that return\nan untyped or error-only response.",
        "additionalProperties": false,
        "properties": {
          "data": {
            "description": "The response payload. Typed callers should prefer Data."
          },
          "errors": {
            "type": "array",
            "description": "One or more errors describing why the request failed. Absent (`null`) on success.",
            "nullable": true,
            "items": {
              "$ref": "#/components/schemas/ConnectApiError"
            }
          },
          "paging": {
            "description": "Paging metadata for list endpoints. Absent on single-item responses.",
            "nullable": true,
            "$ref": "#/components/schemas/Paging"
          }
        }
      },
      "ConnectApiError": {
        "type": "object",
        "description": "A single error entry attached to a ConnectEnvelope`1 or\nConnectEnvelopeObjectResult response. Multiple errors may be returned\nin one response when several problems are detected (e.g. batch validation).",
        "additionalProperties": false,
        "properties": {
          "description": {
            "type": "string",
            "description": "Human-readable explanation of the error. Intended for display to end users or logs.\nWording is not stable and should not be branched on.",
            "nullable": true
          },
          "errorId": {
            "type": "string",
            "description": "Machine-readable, stable error identifier. Consumers should branch on this value\nrather than on Description. See `ConnectErrorIds` for the catalog.",
            "nullable": true
          }
        }
      },
      "Paging": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "limit": {
            "type": "integer",
            "format": "int32"
          },
          "start": {
            "type": "integer",
            "format": "int32"
          },
          "total": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "ConnectEnvelopeOfPlanarPartsClassification2DResponse": {
        "type": "object",
        "description": "Standard response wrapper for every Stella Connect endpoint. Successful responses\npopulate Data; failures populate Errors.\nList responses additionally populate Paging.",
        "additionalProperties": false,
        "properties": {
          "data": {
            "nullable": true,
            "$ref": "#/components/schemas/PlanarPartsClassification2DResponse"
          },
          "errors": {
            "type": "array",
            "description": "One or more errors describing why the request failed. Absent (`null`) on success.",
            "nullable": true,
            "items": {
              "$ref": "#/components/schemas/ConnectApiError"
            }
          },
          "paging": {
            "description": "Paging metadata for list endpoints. Absent on single-item responses.",
            "nullable": true,
            "$ref": "#/components/schemas/Paging"
          }
        }
      },
      "PlanarPartsClassification2DResponse": {
        "type": "object",
        "description": "Response payload for the 2D planar parts-classification endpoint. Returned inside a\n`ConnectEnvelope<PlanarPartsClassification2DResponse>`.",
        "additionalProperties": false,
        "properties": {
          "part": {
            "description": "Classification result for the requested part.",
            "$ref": "#/components/schemas/PlanarPart2DResult"
          }
        }
      },
      "PlanarPart2DResult": {
        "type": "object",
        "description": "Classification of a planar part — a flat sheet-metal item (plate, blank,\nor bent panel derived from a flat pattern).",
        "additionalProperties": false,
        "properties": {
          "partId": {
            "type": "string",
            "description": "Echo of the `PartId` that was classified.",
            "format": "guid"
          },
          "partType": {
            "type": "string",
            "description": "Broad part family. For planar parts this is always the literal\n`\"Planar\"`. (For linear parts the equivalent field echoes the linear\nfamily name — see the linear classification endpoint.)"
          },
          "measurementUnit": {
            "type": "string",
            "description": "Measurement unit of every dimension returned in Dimensions.\nSourced from the CAD file the part was imported from. Common values:\n`\"inch\"`, `\"millimeter\"`, `\"meter\"`. Defaults to\n`\"inch\"` when the file does not specify one."
          },
          "dimensions": {
            "description": "Measured dimensions of the classified flat blank.",
            "$ref": "#/components/schemas/PlanarPartDimensionsResult"
          },
          "bendCount": {
            "type": "integer",
            "description": "Number of detected bend lines. `0` for a flat blank; greater than 0\nfor a bent sheet-metal part (the value here reflects the count of bends\nin the source 3D geometry).",
            "format": "int32"
          }
        }
      },
      "PlanarPartDimensionsResult": {
        "type": "object",
        "description": "Measured dimensions of a planar (sheet-metal) part. All length values are\nexpressed in the MeasurementUnit; areas\nare that unit squared and volume is that unit cubed. Dimensions describe\nthe flat blank — for a bent part these are the dimensions of the unfolded\npattern that would be cut from sheet stock.",
        "additionalProperties": false,
        "properties": {
          "surfaceArea": {
            "type": "number",
            "description": "Flat blank outline area with hole and cutout areas **subtracted** —\nthe actual material area of the sheet.",
            "format": "double"
          },
          "fullSurfaceArea": {
            "type": "number",
            "description": "Flat blank outline area with hole and cutout areas **filled in**\n(outer contour area only). Equals SurfaceArea when the\npart has no holes.",
            "format": "double"
          },
          "contours": {
            "type": "integer",
            "description": "Total count of closed contour loops in the flat pattern — the outer\nprofile plus any inner boundaries (holes, cutouts).",
            "format": "int32"
          },
          "internalLength": {
            "type": "number",
            "description": "Sum of the perimeters of every inner contour (all hole and cutout\nperimeters). Zero when the part has no interior features.",
            "format": "double"
          },
          "length": {
            "type": "number",
            "description": "Bounding-box X extent of the flat outline.",
            "format": "double"
          },
          "cutLength": {
            "type": "number",
            "description": "Total cut-path length — sum of the perimeters of every contour, outer\nplus every inner. Represents the full laser/plasma cut distance.",
            "format": "double"
          },
          "rectangularArea": {
            "type": "number",
            "description": "Area of the axis-aligned bounding rectangle around the flat outline —\n`Length × Width`. Useful as a rough stock-sizing proxy.",
            "format": "double"
          },
          "thickness": {
            "type": "number",
            "description": "Detected sheet-metal gauge. `0` when the classifier could not\ndetermine a thickness (e.g. pure 2D input with no third dimension).",
            "format": "double"
          },
          "width": {
            "type": "number",
            "description": "Bounding-box Y extent of the flat outline.",
            "format": "double"
          },
          "internalSurfaceArea": {
            "type": "number",
            "description": "Combined side-wall area of all interior features (hole and cutout\nperimeters extruded through the sheet thickness). Approximately\n`InternalLength × Thickness`. Zero when there are no interior\nfeatures or when Thickness is 0.",
            "format": "double"
          },
          "volume": {
            "type": "number",
            "description": "Material volume of the flat blank — `SurfaceArea × Thickness`.",
            "format": "double"
          }
        }
      },
      "ConnectEnvelopeOfPlanarNestingOutputResponse": {
        "type": "object",
        "description": "Standard response wrapper for every Stella Connect endpoint. Successful responses\npopulate Data; failures populate Errors.\nList responses additionally populate Paging.",
        "additionalProperties": false,
        "properties": {
          "data": {
            "nullable": true,
            "$ref": "#/components/schemas/PlanarNestingOutputResponse"
          },
          "errors": {
            "type": "array",
            "description": "One or more errors describing why the request failed. Absent (`null`) on success.",
            "nullable": true,
            "items": {
              "$ref": "#/components/schemas/ConnectApiError"
            }
          },
          "paging": {
            "description": "Paging metadata for list endpoints. Absent on single-item responses.",
            "nullable": true,
            "$ref": "#/components/schemas/Paging"
          }
        }
      },
      "ErrorResponse": {
        "type": "object",
        "description": "the dto used to send an error response to the client",
        "additionalProperties": false,
        "properties": {
          "statusCode": {
            "type": "integer",
            "description": "the http status code sent to the client. default is 400.",
            "format": "int32",
            "default": 400
          },
          "message": {
            "type": "string",
            "description": "the message for the error response",
            "default": "One or more errors occurred!"
          },
          "errors": {
            "type": "object",
            "description": "the collection of errors for the current context",
            "additionalProperties": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        }
      },
      "PlanarNestingOutputResponse": {
        "type": "object",
        "description": "Response payload for the planar-parts nesting endpoint. Returned inside a\n`ConnectEnvelope<PlanarNestingOutputResponse>`.",
        "additionalProperties": false,
        "properties": {
          "nestingId": {
            "type": "string",
            "description": "Server-generated identifier for this nesting result. Pass this value to\nthe render-planar-nest endpoint to produce an image of the layout.",
            "format": "guid"
          },
          "parts": {
            "type": "array",
            "description": "Per-part summary — one entry per distinct `PartId` submitted in\nthe request. Carries the part's derived unit weights (bounding-box vs\ntrue shape) but not any layout information.",
            "items": {
              "$ref": "#/components/schemas/PlanarNestedPartResponse"
            }
          },
          "sheets": {
            "type": "array",
            "description": "Per-sheet layout — one entry per physical (or fractional) sheet the\nnester used. Each entry lists the parts placed on that sheet and the\nderived sheet-level weights.",
            "items": {
              "$ref": "#/components/schemas/PlanarSheetResponse"
            }
          }
        }
      },
      "PlanarNestedPartResponse": {
        "type": "object",
        "description": "Per-part summary for a planar nesting result.",
        "additionalProperties": false,
        "properties": {
          "partId": {
            "type": "string",
            "description": "Echo of the `PartId` submitted in the request.",
            "format": "guid"
          },
          "name": {
            "type": "string",
            "description": "Echo of the `PartName` supplied in the request."
          },
          "unitRectangularWeight": {
            "type": "number",
            "description": "Bounding-box weight of one copy of the part —\n`RectangularArea × Thickness × Density`. Ignores holes and\ncutouts; useful as an upper bound on material consumption.",
            "format": "double"
          },
          "unitTrueWeight": {
            "type": "number",
            "description": "True-shape weight of one copy of the part —\n`SurfaceArea × Thickness × Density`. Holes and cutouts are\nsubtracted, so this is the actual mass of the finished blank.",
            "format": "double"
          },
          "density": {
            "type": "number",
            "description": "Echo of the sheet material density used to derive weights.",
            "format": "double"
          },
          "densityUnit": {
            "type": "string",
            "description": "Unit for Density (e.g. `\"pound_per_cubic_inch\"`)."
          }
        }
      },
      "PlanarSheetResponse": {
        "type": "object",
        "description": "Per-sheet layout entry in a planar nesting result. One entry per physical\n(or fractional) sheet the nester placed parts on.",
        "additionalProperties": false,
        "properties": {
          "sheetId": {
            "type": "string",
            "description": "Server-generated identifier for this sheet instance within the nest.",
            "format": "guid"
          },
          "name": {
            "type": "string",
            "description": "Echo of the sheet `Name` supplied in the request."
          },
          "productId": {
            "type": "string",
            "description": "Reserved for future use. Currently always `null`."
          },
          "thickness": {
            "type": "number",
            "description": "Sheet thickness, in the request's `ThicknessUnit`.",
            "format": "double"
          },
          "length": {
            "type": "number",
            "description": "Length (long side) of the chosen sheet size, in\nLengthUnit.",
            "format": "double"
          },
          "width": {
            "type": "number",
            "description": "Width (short side) of the chosen sheet size, in\nLengthUnit.",
            "format": "double"
          },
          "lengthUsed": {
            "type": "number",
            "description": "Length (long side) of the material actually consumed on this sheet, in\nLengthUnit. When KeepRemnant is\n`false` this equals Length; when a remnant was\ncropped off, it is the extent of the retained cut region.",
            "format": "double"
          },
          "widthUsed": {
            "type": "number",
            "description": "Width (short side) of the material actually consumed on this sheet, in\nLengthUnit. Counterpart to LengthUsed.",
            "format": "double"
          },
          "lengthUnit": {
            "type": "string",
            "description": "Length unit for Length, Width,\nLengthUsed, WidthUsed, and\nThickness. Reflects the request's `OutputLengthUnit`."
          },
          "weight": {
            "type": "number",
            "description": "Weight of a single full sheet at this size —\n`Length × Width × Thickness × Density`. Rounded to three decimals.",
            "format": "double"
          },
          "weightUnit": {
            "type": "string",
            "description": "Unit for Weight and TotalWeight (always\n`\"pound\"`)."
          },
          "totalWeight": {
            "type": "number",
            "description": "Combined weight of all sheets of this size actually consumed —\n`Weight × TotalSheets`. Reflects fractional sheet usage when\nKeepRemnant is `true`. Rounded to three decimals.",
            "format": "double"
          },
          "numberOfSheetsRequired": {
            "type": "integer",
            "description": "Physical count of full sheets of this size required to complete the\nnest. Always rounded up from TotalSheets.",
            "format": "int32"
          },
          "totalSheets": {
            "type": "number",
            "description": "Fractional sheet count actually consumed. When KeepRemnant\nis `true`, the final sheet may be a fraction (≤ 1) representing\nthe portion that was cut before the remnant policy stopped further\nnesting. Otherwise equals NumberOfSheetsRequired.",
            "format": "double"
          },
          "keepRemnant": {
            "type": "boolean",
            "description": "Whether the nester actually kept a remnant on this sheet size. This is\nthe effective decision — the nester may report `false` even when\nthe request asked to keep a remnant, if the leftover was smaller than\nthe configured minimums."
          },
          "remnantCropType": {
            "type": "string",
            "description": "Shape of the retained remnant. One of `\"VerticalCrop\"`,\n`\"HorizontalCrop\"`, `\"LShapeCrop\"`, or `\"NoCrop\"`."
          },
          "nestedParts": {
            "type": "array",
            "description": "Per-part usage on this sheet — one entry per distinct `PartId`\nplaced on it, with the count of copies and derived weights.",
            "items": {
              "$ref": "#/components/schemas/PlanarNestedPartUsageResponse"
            }
          }
        }
      },
      "PlanarNestedPartUsageResponse": {
        "type": "object",
        "description": "Per-part usage entry on a single PlanarSheetResponse.",
        "additionalProperties": false,
        "properties": {
          "partId": {
            "type": "string",
            "description": "Echo of the `PartId` that was placed on this sheet.",
            "format": "guid"
          },
          "unitNestedWeight": {
            "type": "number",
            "description": "Weight of one nested copy accounting for grain and orientation as\nactually placed on this sheet.",
            "format": "double"
          },
          "unitTrueWeight": {
            "type": "number",
            "description": "True-shape weight of one copy of the part —\n`SurfaceArea × Thickness × Density`. Matches\nUnitTrueWeight.",
            "format": "double"
          },
          "totalNumberOfUnitsNested": {
            "type": "integer",
            "description": "Number of copies of this PartId placed on this sheet.",
            "format": "int32"
          }
        }
      },
      "PlanarNestingRequest": {
        "type": "object",
        "description": "Request body for the planar-parts nesting endpoint. Nests one or more\nclassified planar (sheet-metal) parts onto sheet stock and returns per-sheet\nlayout usage plus per-part weights.",
        "additionalProperties": false,
        "required": [
          "parts",
          "sheet",
          "outputLengthUnit"
        ],
        "properties": {
          "parts": {
            "type": "array",
            "description": "Parts to nest. Each entry references a previously imported and classified\nplanar part by `PartId` together with its requested quantity.",
            "minLength": 1,
            "nullable": false,
            "items": {
              "$ref": "#/components/schemas/PlanarNestingPartItem"
            }
          },
          "sheet": {
            "description": "Sheet stock definition — material properties, thickness, and one or more\ncandidate sheet sizes the nester may draw from.",
            "nullable": false,
            "$ref": "#/components/schemas/PlanarNestingSheet"
          },
          "options": {
            "description": "Nesting behavior options — part-to-part / part-to-edge clearances and a\nglobal remnant policy that applies to every generated layout.",
            "$ref": "#/components/schemas/PlanarNestingOptions"
          },
          "outputLengthUnit": {
            "type": "string",
            "description": "Unit for length values in the response (e.g. `Length`, `Width`,\n`Thickness`). Common values: `\"inch\"`, `\"millimeter\"`,\n`\"meter\"`. Defaults to `\"inch\"`.",
            "minLength": 1,
            "nullable": false
          }
        }
      },
      "PlanarNestingPartItem": {
        "type": "object",
        "description": "Single part entry in a planar nesting request.",
        "additionalProperties": false,
        "properties": {
          "partId": {
            "type": "string",
            "description": "`PartId` of a previously imported and classified planar part.",
            "format": "guid"
          },
          "partName": {
            "type": "string",
            "description": "Free-form display name echoed back on the corresponding\n`Parts[].Name` in the response."
          },
          "grain": {
            "type": "boolean",
            "description": "Grain-alignment constraint. When `true`, the nester may only rotate\nthe part by `0°` or `180°` (grain axis preserved). When\n`false`, `90°` rotations are also allowed."
          },
          "quantity": {
            "type": "integer",
            "description": "Number of copies of this part to nest. Must be greater than zero.",
            "format": "int32"
          },
          "measurementUnit": {
            "type": "string",
            "description": "Length unit the part's cached dimensions are expressed in. Common\nvalues: `\"inch\"`, `\"millimeter\"`, `\"meter\"`."
          }
        }
      },
      "PlanarNestingSheet": {
        "type": "object",
        "description": "Sheet-stock definition for a planar nesting request.",
        "additionalProperties": false,
        "properties": {
          "name": {
            "type": "string",
            "description": "Free-form display name echoed back on the corresponding\n`Sheets[].Name` in the response."
          },
          "density": {
            "type": "number",
            "description": "Material density used to derive sheet and part weights.",
            "format": "double"
          },
          "densityUnit": {
            "type": "string",
            "description": "Unit for Density (e.g. `\"pound_per_cubic_inch\"`,\n`\"kilogram_per_cubic_meter\"`)."
          },
          "thickness": {
            "type": "number",
            "description": "Sheet thickness (gauge) in ThicknessUnit.",
            "format": "double"
          },
          "thicknessUnit": {
            "type": "string",
            "description": "Length unit for Thickness."
          },
          "sizes": {
            "type": "array",
            "description": "Candidate sheet sizes. Provide one or more; the nester picks the best\nfit for each layout. Each size may carry its own per-size remnant\npolicy that overrides Remnant.",
            "items": {
              "$ref": "#/components/schemas/PlanarSheetSize"
            }
          }
        }
      },
      "PlanarSheetSize": {
        "type": "object",
        "description": "One candidate sheet size in a PlanarNestingSheet.",
        "additionalProperties": false,
        "properties": {
          "length": {
            "type": "number",
            "description": "Sheet length (long side) in LengthUnit.",
            "format": "double"
          },
          "lengthUnit": {
            "type": "string",
            "description": "Length unit for Length. Common values: `\"inch\"`,\n`\"millimeter\"`, `\"meter\"`."
          },
          "width": {
            "type": "number",
            "description": "Sheet width (short side) in WidthUnit.",
            "format": "double"
          },
          "widthUnit": {
            "type": "string",
            "description": "Length unit for Width. Common values: `\"inch\"`,\n`\"millimeter\"`, `\"meter\"`."
          },
          "quantity": {
            "type": "integer",
            "description": "Maximum number of sheets of this size available. `null` or\n`0` is treated as unlimited.",
            "format": "int32",
            "nullable": true
          },
          "variantId": {
            "type": "string",
            "description": "Caller-defined identifier that ties this size to an external stock\nrecord. Not interpreted by the nester; echo only."
          },
          "remnant": {
            "description": "Per-size remnant policy. When present, overrides\nRemnant for this sheet size.",
            "$ref": "#/components/schemas/PlanarRemnantOptions"
          }
        }
      },
      "PlanarRemnantOptions": {
        "type": "object",
        "description": "Remnant (leftover) policy for a planar sheet size. Controls whether the\nnester preserves useful leftovers and, if so, the minimum useful size.",
        "additionalProperties": false,
        "properties": {
          "keepRemnant": {
            "type": "boolean",
            "description": "When `true`, the nester is allowed to leave a useful leftover on\nthe final sheet (fractional sheet). When `false`, sheets are\nnested full."
          },
          "minimumWidth": {
            "type": "number",
            "description": "Minimum leftover width to be considered a keepable remnant. Both\nMinimumWidth and MinimumLength must clear\ntheir thresholds for a remnant to be kept.",
            "format": "double",
            "nullable": true
          },
          "widthUnit": {
            "type": "string",
            "description": "Length unit for MinimumWidth."
          },
          "minimumLength": {
            "type": "number",
            "description": "Minimum leftover length to be considered a keepable remnant. Both\nMinimumLength and MinimumWidth must clear\ntheir thresholds for a remnant to be kept.",
            "format": "double",
            "nullable": true
          },
          "lengthUnit": {
            "type": "string",
            "description": "Length unit for MinimumLength."
          }
        }
      },
      "PlanarNestingOptions": {
        "type": "object",
        "description": "Nesting behavior options that apply globally to every generated layout.",
        "additionalProperties": false,
        "properties": {
          "clearance": {
            "description": "Clearance (empty gap) requirements between parts and between parts and\nthe sheet edge.",
            "$ref": "#/components/schemas/PlanarClearanceOptions"
          },
          "remnant": {
            "description": "Default remnant policy. Applies to any sheet size that does not carry\nits own Remnant.",
            "$ref": "#/components/schemas/PlanarRemnantOptions"
          }
        }
      },
      "PlanarClearanceOptions": {
        "type": "object",
        "description": "Clearance (empty gap) requirements for a planar nest.",
        "additionalProperties": false,
        "properties": {
          "part": {
            "type": "number",
            "description": "Minimum empty gap between neighboring parts. Expressed in\nPartUnit.",
            "format": "float"
          },
          "partUnit": {
            "type": "string",
            "description": "Length unit for Part."
          },
          "edge": {
            "type": "number",
            "description": "Minimum empty gap between any part and the outer edge of the sheet.\nExpressed in EdgeUnit.",
            "format": "float"
          },
          "edgeUnit": {
            "type": "string",
            "description": "Length unit for Edge."
          }
        }
      },
      "ConnectEnvelopeOfRenderPartResponse": {
        "type": "object",
        "description": "Standard response wrapper for every Stella Connect endpoint. Successful responses\npopulate Data; failures populate Errors.\nList responses additionally populate Paging.",
        "additionalProperties": false,
        "properties": {
          "data": {
            "nullable": true,
            "$ref": "#/components/schemas/RenderPartResponse"
          },
          "errors": {
            "type": "array",
            "description": "One or more errors describing why the request failed. Absent (`null`) on success.",
            "nullable": true,
            "items": {
              "$ref": "#/components/schemas/ConnectApiError"
            }
          },
          "paging": {
            "description": "Paging metadata for list endpoints. Absent on single-item responses.",
            "nullable": true,
            "$ref": "#/components/schemas/Paging"
          }
        }
      },
      "RenderPartResponse": {
        "type": "object",
        "description": "Response payload for the render-part endpoints. Returned inside a\n`ConnectEnvelope<RenderPartResponse>`.",
        "additionalProperties": false,
        "required": [
          "partId",
          "imageData"
        ],
        "properties": {
          "partId": {
            "type": "string",
            "description": "Echo of the `PartId` that was rendered.",
            "format": "guid"
          },
          "imageData": {
            "type": "string",
            "description": "Rendered image, base64-encoded. Decode to bytes and interpret according to\nthe requested `ImageType` (PNG or SVG)."
          }
        }
      },
      "ConnectEnvelopeOfRenderPlanarNestResponse": {
        "type": "object",
        "description": "Standard response wrapper for every Stella Connect endpoint. Successful responses\npopulate Data; failures populate Errors.\nList responses additionally populate Paging.",
        "additionalProperties": false,
        "properties": {
          "data": {
            "nullable": true,
            "$ref": "#/components/schemas/RenderPlanarNestResponse"
          },
          "errors": {
            "type": "array",
            "description": "One or more errors describing why the request failed. Absent (`null`) on success.",
            "nullable": true,
            "items": {
              "$ref": "#/components/schemas/ConnectApiError"
            }
          },
          "paging": {
            "description": "Paging metadata for list endpoints. Absent on single-item responses.",
            "nullable": true,
            "$ref": "#/components/schemas/Paging"
          }
        }
      },
      "ImageTypeRequest": {
        "type": "string",
        "description": "Supported output image formats for render endpoints.",
        "x-enumNames": [
          "Png",
          "Svg"
        ],
        "enum": [
          "Png",
          "Svg"
        ]
      },
      "RenderPlanarNestResponse": {
        "type": "object",
        "description": "Response payload for the render-planar-nest endpoint. Returned inside a\n`ConnectEnvelope<RenderPlanarNestResponse>`. Every sheet in the\nnest is rendered — the `SheetId` path parameter is currently ignored.",
        "additionalProperties": false,
        "properties": {
          "nestId": {
            "type": "string",
            "description": "Echo of the `NestId` that was rendered.",
            "format": "guid"
          },
          "images": {
            "type": "array",
            "description": "One rendered image per sheet in the nest.",
            "items": {
              "$ref": "#/components/schemas/RenderPlanarNestImage"
            }
          }
        }
      },
      "RenderPlanarNestImage": {
        "type": "object",
        "description": "Single rendered sheet image within a RenderPlanarNestResponse.",
        "additionalProperties": false,
        "properties": {
          "sheetId": {
            "type": "string",
            "description": "Identifier of the sheet this image belongs to. Matches a\n`Sheets[].SheetId` from the originating nesting response.",
            "format": "guid"
          },
          "imageData": {
            "type": "string",
            "description": "Rendered sheet image, base64-encoded PNG. Decode to bytes to obtain\nthe raw image. The `data:image/png;base64,` URI prefix has been\nstripped."
          }
        }
      },
      "RenderPlanarNestRequest": {
        "type": "object",
        "description": "Request body for the render-planar-nest endpoint. Renders a previously\ncomputed planar nesting to a rasterized image per sheet.",
        "additionalProperties": false,
        "properties": {
          "imageWidth": {
            "type": "integer",
            "description": "Image width in pixels. Must be greater than zero. Defaults to\n`1280`.",
            "format": "int32",
            "minimum": 0,
            "exclusiveMinimum": true
          },
          "imageHeight": {
            "type": "integer",
            "description": "Image height in pixels. Must be greater than zero. Defaults to\n`1024`.",
            "format": "int32",
            "minimum": 0,
            "exclusiveMinimum": true
          },
          "backgroundColor": {
            "type": "string",
            "description": "Canvas background color as an HTML hex string (e.g. `\"#FFFFFF\"`,\n`\"#000000\"`). Defaults to `\"#FFFFFF\"` (white)."
          },
          "shouldKeepRemnant": {
            "type": "boolean",
            "description": "When `true`, draws the remnant crop overlay (the cut-line polygon\nthat separates the retained remnant from the discarded scrap). Styled\nby Crop. The remnant geometry itself comes from the\nnest's `RemnantCropType` and its effective `KeepRemnant`\ndecision. When `false`, no crop overlay is drawn."
          },
          "shouldRenderFullSheet": {
            "type": "boolean",
            "description": "Only meaningful when ShouldKeepRemnant is `true`.\nWhen `false`, the crop boundary is drawn at the actual used\nextent of the parts. When `true`, the boundary is extended to\ninclude the edge-clearance buffer, making the entire usable area\nappear as remnant rather than just the tight bounding rectangle\naround the placed parts."
          },
          "crop": {
            "description": "Styling for the remnant crop overlay (the cut-line polygon and its\nfill). Only applied when ShouldKeepRemnant is\n`true`.",
            "$ref": "#/components/schemas/NestRenderingOptions"
          },
          "deadZone": {
            "description": "Styling for the no-nesting buffer zone at the sheet origin (the inset\nrectangle from the bottom-left where parts are not allowed to be\nplaced). Only rendered when the nest has a non-zero dead-zone offset.",
            "$ref": "#/components/schemas/NestRenderingOptions"
          },
          "part": {
            "description": "Styling for placed (used) parts on the sheet.",
            "$ref": "#/components/schemas/NestRenderingOptions"
          },
          "remnant": {
            "description": "Styling for unused / leftover positions on the sheet.",
            "$ref": "#/components/schemas/NestRenderingOptions"
          }
        }
      },
      "NestRenderingOptions": {
        "type": "object",
        "description": "Styling for one element category on a rendered nest (chuck, kerf, part, or\nremnant). Colors are HTML hex strings — `#RRGGBB` or `#AARRGGBB`\n(alpha first). A fill of `#00000000` means fully transparent.",
        "additionalProperties": false,
        "properties": {
          "fillColor": {
            "type": "string",
            "description": "Fill color as an HTML hex string. Supports optional alpha:\n`#RGB`, `#RRGGBB`, or `#AARRGGBB`. Default: `#00000000`\n(fully transparent)."
          },
          "hatchStyle": {
            "description": "Hatch pattern applied on top of FillColor. Values are those\nof HatchStyle (e.g. `Horizontal`,\n`Cross`, `ForwardDiagonal`, `Percent50`). Null means no\nhatching.",
            "nullable": true,
            "$ref": "#/components/schemas/HatchStyle"
          },
          "strokeColor": {
            "type": "string",
            "description": "Stroke color as an HTML hex string. Default: `#000000` (black)."
          },
          "strokeStyle": {
            "description": "Stroke dash pattern. One of `Solid`, `Dash`, `Dot`,\n`DashDot`, `DashDotDot`, `Custom`. Default: `Solid`.",
            "$ref": "#/components/schemas/StrokeStyle"
          }
        }
      },
      "HatchStyle": {
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Horizontal",
          "Vertical",
          "ForwardDiagonal",
          "BackwardDiagonal",
          "Cross",
          "DiagonalCross",
          "Percent05",
          "Percent10",
          "Percent20",
          "Percent25",
          "Percent30",
          "Percent40",
          "Percent50",
          "Percent60",
          "Percent70",
          "Percent75",
          "Percent80",
          "Percent90",
          "LightDownwardDiagonal",
          "LightUpwardDiagonal",
          "DarkDownwardDiagonal",
          "DarkUpwardDiagonal",
          "WideDownwardDiagonal",
          "WideUpwardDiagonal",
          "LightVertical",
          "LightHorizontal",
          "NarrowVertical",
          "NarrowHorizontal",
          "DarkVertical",
          "DarkHorizontal",
          "DashedDownwardDiagonal",
          "DashedUpwardDiagonal",
          "DashedHorizontal",
          "DashedVertical",
          "SmallConfetti",
          "LargeConfetti",
          "ZigZag",
          "Wave",
          "DiagonalBrick",
          "HorizontalBrick",
          "Weave",
          "Plaid",
          "Divot",
          "DottedGrid",
          "DottedDiamond",
          "Shingle",
          "Trellis",
          "Sphere",
          "SmallGrid",
          "SmallCheckerBoard",
          "LargeCheckerBoard",
          "OutlinedDiamond",
          "SolidDiamond"
        ],
        "enum": [
          "Horizontal",
          "Vertical",
          "ForwardDiagonal",
          "BackwardDiagonal",
          "Cross",
          "DiagonalCross",
          "Percent05",
          "Percent10",
          "Percent20",
          "Percent25",
          "Percent30",
          "Percent40",
          "Percent50",
          "Percent60",
          "Percent70",
          "Percent75",
          "Percent80",
          "Percent90",
          "LightDownwardDiagonal",
          "LightUpwardDiagonal",
          "DarkDownwardDiagonal",
          "DarkUpwardDiagonal",
          "WideDownwardDiagonal",
          "WideUpwardDiagonal",
          "LightVertical",
          "LightHorizontal",
          "NarrowVertical",
          "NarrowHorizontal",
          "DarkVertical",
          "DarkHorizontal",
          "DashedDownwardDiagonal",
          "DashedUpwardDiagonal",
          "DashedHorizontal",
          "DashedVertical",
          "SmallConfetti",
          "LargeConfetti",
          "ZigZag",
          "Wave",
          "DiagonalBrick",
          "HorizontalBrick",
          "Weave",
          "Plaid",
          "Divot",
          "DottedGrid",
          "DottedDiamond",
          "Shingle",
          "Trellis",
          "Sphere",
          "SmallGrid",
          "SmallCheckerBoard",
          "LargeCheckerBoard",
          "OutlinedDiamond",
          "SolidDiamond"
        ]
      },
      "StrokeStyle": {
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Solid",
          "Dash",
          "Dot",
          "DashDot",
          "DashDotDot",
          "Custom"
        ],
        "enum": [
          "Solid",
          "Dash",
          "Dot",
          "DashDot",
          "DashDotDot",
          "Custom"
        ]
      },
      "ConnectEnvelopeOfImportFilesResponse": {
        "type": "object",
        "description": "Standard response wrapper for every Stella Connect endpoint. Successful responses\npopulate Data; failures populate Errors.\nList responses additionally populate Paging.",
        "additionalProperties": false,
        "properties": {
          "data": {
            "nullable": true,
            "$ref": "#/components/schemas/ImportFilesResponse"
          },
          "errors": {
            "type": "array",
            "description": "One or more errors describing why the request failed. Absent (`null`) on success.",
            "nullable": true,
            "items": {
              "$ref": "#/components/schemas/ConnectApiError"
            }
          },
          "paging": {
            "description": "Paging metadata for list endpoints. Absent on single-item responses.",
            "nullable": true,
            "$ref": "#/components/schemas/Paging"
          }
        }
      },
      "ImportFilesResponse": {
        "type": "object",
        "description": "Response payload for the file-import endpoints. Returned inside a\n`ConnectEnvelope<ImportFilesResponse>`.",
        "additionalProperties": false,
        "properties": {
          "files": {
            "type": "array",
            "description": "One entry per uploaded file, in the order the files were received.",
            "items": {
              "$ref": "#/components/schemas/File"
            }
          }
        }
      },
      "File": {
        "type": "object",
        "description": "An imported source file together with the parts extracted from it.",
        "additionalProperties": false,
        "properties": {
          "fileId": {
            "type": "string",
            "description": "Stable identifier for the imported file. Persist this to reference the file\nin subsequent calls.",
            "format": "guid"
          },
          "name": {
            "type": "string",
            "description": "Original file name as supplied at upload time."
          },
          "parts": {
            "type": "array",
            "description": "Every part extracted from the file. A file with a single closed contour yields\none entry; multi-body files yield one entry per body.",
            "items": {
              "$ref": "#/components/schemas/Part"
            }
          }
        }
      },
      "Part": {
        "type": "object",
        "description": "A single part extracted from an imported file.",
        "additionalProperties": false,
        "properties": {
          "partId": {
            "type": "string",
            "description": "Stable identifier for the extracted part. Required by classification, nesting\nand rendering endpoints.",
            "format": "guid"
          },
          "name": {
            "type": "string",
            "description": "Part name derived from the CAD file, or a synthesized default when the file\ndoes not name the part."
          }
        }
      },
      "ImportFilesRequest": {
        "type": "object",
        "description": "Common base for file-import requests. Sent as `multipart/form-data`.",
        "additionalProperties": false,
        "required": [
          "files"
        ],
        "properties": {
          "files": {
            "type": "array",
            "description": "One or more CAD files to import. See the endpoint description for supported\nformats. A single file may contain multiple parts; separate closed contours are\nextracted as distinct parts.",
            "minLength": 1,
            "nullable": false,
            "items": {
              "type": "string",
              "format": "binary"
            }
          }
        }
      },
      "ConnectEnvelopeOfRenderFileResponse": {
        "type": "object",
        "description": "Standard response wrapper for every Stella Connect endpoint. Successful responses\npopulate Data; failures populate Errors.\nList responses additionally populate Paging.",
        "additionalProperties": false,
        "properties": {
          "data": {
            "nullable": true,
            "$ref": "#/components/schemas/RenderFileResponse"
          },
          "errors": {
            "type": "array",
            "description": "One or more errors describing why the request failed. Absent (`null`) on success.",
            "nullable": true,
            "items": {
              "$ref": "#/components/schemas/ConnectApiError"
            }
          },
          "paging": {
            "description": "Paging metadata for list endpoints. Absent on single-item responses.",
            "nullable": true,
            "$ref": "#/components/schemas/Paging"
          }
        }
      },
      "RenderFileResponse": {
        "type": "object",
        "description": "Response payload for the render-file endpoints. Returned inside a\n`ConnectEnvelope<RenderFileResponse>`.",
        "additionalProperties": false,
        "required": [
          "fileId",
          "imageData"
        ],
        "properties": {
          "fileId": {
            "type": "string",
            "description": "Echo of the `FileId` that was rendered.",
            "format": "guid"
          },
          "imageData": {
            "type": "string",
            "description": "Rendered image, base64-encoded. Decode to bytes and interpret according to\nthe requested `ImageType` (PNG or SVG)."
          }
        }
      },
      "ConnectEnvelopeOfLinearPartsClassificationResponse": {
        "type": "object",
        "description": "Standard response wrapper for every Stella Connect endpoint. Successful responses\npopulate Data; failures populate Errors.\nList responses additionally populate Paging.",
        "additionalProperties": false,
        "properties": {
          "data": {
            "nullable": true,
            "$ref": "#/components/schemas/LinearPartsClassificationResponse"
          },
          "errors": {
            "type": "array",
            "description": "One or more errors describing why the request failed. Absent (`null`) on success.",
            "nullable": true,
            "items": {
              "$ref": "#/components/schemas/ConnectApiError"
            }
          },
          "paging": {
            "description": "Paging metadata for list endpoints. Absent on single-item responses.",
            "nullable": true,
            "$ref": "#/components/schemas/Paging"
          }
        }
      },
      "LinearPartsClassificationResponse": {
        "type": "object",
        "description": "Response payload for the linear parts-classification endpoints. Returned inside a\n`ConnectEnvelope<LinearPartsClassificationResponse>`.",
        "additionalProperties": false,
        "properties": {
          "part": {
            "description": "Classification result for the requested part.",
            "$ref": "#/components/schemas/LinearClassifiedPartResult"
          }
        }
      },
      "LinearClassifiedPartResult": {
        "type": "object",
        "description": "Classification of a linear part — stock items whose geometry is dominated by a\nsingle long axis (bars, tubes, structural shapes, pipes).",
        "additionalProperties": false,
        "properties": {
          "partId": {
            "type": "string",
            "description": "Echo of the `PartId` that was classified.",
            "format": "guid"
          },
          "partType": {
            "type": "string",
            "description": "Broad part family. For linear parts this currently echoes\nLinearPartType — one of `\"Bar\"`, `\"Tube\"`,\n`\"Structural\"`, `\"Pipe\"`, or `\"Unknown\"`. Consumers integrating\nagainst both linear and planar endpoints should note that the planar endpoints\nreturn the literal `\"Planar\"` here instead."
          },
          "measurementUnit": {
            "type": "string",
            "description": "Measurement unit of every dimension returned in Dimensions.\nSourced from the CAD file the part was imported from. Common values:\n`\"inch\"`, `\"millimeter\"`, `\"meter\"`. Defaults to `\"inch\"`\nwhen the file does not specify one."
          },
          "linearPartType": {
            "type": "string",
            "description": "Linear family classification. One of:\n`\"Bar\"` (solid stock),\n`\"Tube\"` (hollow closed-profile stock),\n`\"Structural\"` (rolled structural shapes — I-beam, channel, angle),\n`\"Pipe\"` (currently not returned — reserved),\nor `\"Unknown\"` when the classifier cannot identify a linear family."
          },
          "linearPartSubType": {
            "type": "string",
            "description": "Specific cross-section within LinearPartType. Values:\n\"Bar_Flat\", \"Bar_Square\", \"Bar_Round\", \"Bar_Hex\"\n\"Tube_Round\", \"Tube_Square\", \"Tube_Rectangular\"\n\"Structural_IBeam\", \"Structural_Channel\", \"Structural_Angle\"\n\"Pipe_Seamless\", \"Pipe_Welded\" — reserved; not currently returned"
          },
          "dimensions": {
            "description": "Measured dimensions of the classified part. Null when the classifier could\nnot extract dimensions (e.g. LinearPartSubType is unknown).",
            "nullable": true,
            "$ref": "#/components/schemas/LinearClassifiedPartDimensionsResult"
          }
        }
      },
      "LinearClassifiedPartDimensionsResult": {
        "type": "object",
        "description": "Measured dimensions of a linear part. All length values are expressed in the\nMeasurementUnit; areas are that unit\nsquared and volume is that unit cubed.",
        "additionalProperties": false,
        "properties": {
          "crossSectionalDimensions": {
            "description": "Dimensions of the part's cross-section (the profile perpendicular to its\nlong axis). Null when a cross-section could not be extracted.",
            "nullable": true,
            "$ref": "#/components/schemas/CrossSectionalDimensionsResult"
          },
          "contours": {
            "type": "integer",
            "description": "Number of closed contours in the part's cross-section — the outer profile\nplus any inner boundaries (e.g. a round tube has 2: outer circle + bore).",
            "format": "int32"
          },
          "internalLength": {
            "type": "number",
            "description": "Sum of the perimeter lengths of every inner contour on the cross-section\n(e.g. the bore perimeter of a tube, plus any through-holes). Zero for solid\nparts with no inner contours.",
            "format": "double"
          },
          "length": {
            "type": "number",
            "description": "Overall length along the part's primary axis, measured from the tightest\naxis-aligned bounding box (fillet corners excluded).",
            "format": "double"
          },
          "profileLength": {
            "type": "number",
            "description": "Perimeter of the cross-section's outer contour (the \"profile\" length).",
            "format": "double"
          },
          "surfaceArea": {
            "type": "number",
            "description": "Total outer skin area of the part, including both end caps but excluding\ninterior hole/bore walls.",
            "format": "double"
          },
          "outsideSurfaceArea": {
            "type": "number",
            "description": "Area of the outer wall along the part's length (excludes end caps).\nPopulated only for tubes and pipes; null for bars and structural shapes.",
            "format": "double",
            "nullable": true
          },
          "insideSurfaceArea": {
            "type": "number",
            "description": "Area of the inner bore wall along the part's length (excludes end caps).\nPopulated only for tubes and pipes; null for bars and structural shapes.",
            "format": "double",
            "nullable": true
          },
          "internalSurfaceArea": {
            "type": "number",
            "description": "Sum of the wall areas of all interior features other than a tube's bore —\nthrough-holes, counterbores, chamfers, notches. Zero for parts with no such\nfeatures. Note: for tubes the bore wall itself is reported in\nInsideSurfaceArea, not here.",
            "format": "double"
          },
          "crossSectionalSurfaceArea": {
            "type": "number",
            "description": "Combined area of the two end-cap faces (both cut ends). For tubes this is\ntwice the annular ring area; for solid bars it is twice the filled\ncross-section area.",
            "format": "double"
          },
          "volume": {
            "type": "number",
            "description": "Material volume of the part, computed from the tessellated B-rep. Accounts\nfor holes, chamfers, notches, and tapers — not a simple\n`ProfileArea × Length` approximation.",
            "format": "double"
          }
        }
      },
      "CrossSectionalDimensionsResult": {
        "type": "object",
        "description": "Cross-section measurements. Dim1–Dim4 are the raw\nbounding/scan values; the named nullable fields are semantic aliases populated\nonly for the subtypes where they are meaningful (see each field for the\nsubtype-to-value matrix).",
        "additionalProperties": false,
        "properties": {
          "dim1": {
            "type": "number",
            "description": "Primary cross-section dimension. Meaning varies by\nLinearPartSubType:\nSubTypeDim1\nBar_Flatlonger bbox side (width)\nBar_Squareside length\nBar_Rounddiameter\nBar_Hexflat-to-flat width\nTube_Roundoutside diameter\nTube_Squareoutside side length\nTube_Rectangularlonger outer side\nPipe_Seamless / Pipe_Weldedoutside diameter (reserved)\nStructural_Anglelonger leg (outer bbox)\nStructural_Channel / Structural_IBeamheight (longer outer dim)",
            "format": "double"
          },
          "dim2": {
            "type": "number",
            "description": "Secondary cross-section dimension. Meaning varies by subtype:\nSubTypeDim2\nBar_Flatshorter bbox side (height)\nTube_Roundwall thickness\nTube_Squarewall thickness\nTube_Rectangularshorter outer side\nPipe_Seamless / Pipe_Weldedinside diameter (reserved)\nStructural_Angleshorter leg\nStructural_Channel / Structural_IBeamflange width (shorter bbox dim)\nBar_Square / Bar_Round / Bar_Hexnot populated",
            "format": "double"
          },
          "dim3": {
            "type": "number",
            "description": "Tertiary cross-section dimension. Meaning varies by subtype:\nSubTypeDim3\nTube_Rectangularwall thickness\nPipe_Seamless / Pipe_Weldedwall thickness (reserved)\nStructural_Angleleg thickness\nStructural_Channel / Structural_IBeamflange/web thickness\nAll bar and single-thickness tube subtypesnot populated",
            "format": "double"
          },
          "dim4": {
            "type": "number",
            "description": "Reserved for future use. Not currently populated by any subtype.",
            "format": "double"
          },
          "size": {
            "type": "number",
            "description": "Side length of a square-section part. Populated only for\n`Bar_Square`; null otherwise.",
            "format": "double",
            "nullable": true
          },
          "height": {
            "type": "number",
            "description": "Height of the cross-section (shorter outer dimension for flats/rectangles;\nfull height of the section for structural shapes). Populated for:\nBar_Flat — shorter bbox side\nTube_Rectangular — shorter outer side\nTube_Square — outer side (same as Width)\nStructural_Angle — shorter leg\nStructural_Channel, Structural_IBeam — overall height\nNull for all other subtypes.",
            "format": "double",
            "nullable": true
          },
          "width": {
            "type": "number",
            "description": "Width of the cross-section (longer outer dimension). Populated for:\nBar_Flat — longer bbox side\nTube_Rectangular — longer outer side\nTube_Square — outer side (same as Height)\nStructural_Angle — longer leg\nNull for all other subtypes.",
            "format": "double",
            "nullable": true
          },
          "diameter": {
            "type": "number",
            "description": "Diameter of a round cross-section. Populated for:\nBar_Round — full diameter\nBar_Hex — flat-to-flat width (nominal diameter)\nNull for all other subtypes; use OutsideDiameter for tubes and pipes.",
            "format": "double",
            "nullable": true
          },
          "outsideDiameter": {
            "type": "number",
            "description": "Outside diameter of a hollow round section. Populated for\n`Tube_Round` and (reserved) `Pipe_Seamless` / `Pipe_Welded`.\nNull for all other subtypes.",
            "format": "double",
            "nullable": true
          },
          "insideDiameter": {
            "type": "number",
            "description": "Inside (bore) diameter of a hollow round section. Populated only for\n(reserved) `Pipe_Seamless` / `Pipe_Welded`. Null otherwise —\nincluding for `Tube_Round`, which reports\nOutsideDiameter and WallThickness instead.",
            "format": "double",
            "nullable": true
          },
          "wallThickness": {
            "type": "number",
            "description": "Wall thickness of a hollow section. Populated for\n`Tube_Round`, `Tube_Square`, `Tube_Rectangular`, and\n(reserved) `Pipe_Seamless` / `Pipe_Welded`. Null for all bar\nand structural subtypes — see Thickness for structural angles.",
            "format": "double",
            "nullable": true
          },
          "thickness": {
            "type": "number",
            "description": "Leg thickness of a structural angle. Populated only for\n`Structural_Angle`; null for all other subtypes.",
            "format": "double",
            "nullable": true
          },
          "webThickness": {
            "type": "number",
            "description": "Nominal web/flange thickness of a structural section. Derived from the\nnarrower bounding-box dimension of the cross-section. Populated for\n`Structural_Channel` and `Structural_IBeam`; null otherwise.",
            "format": "double",
            "nullable": true
          },
          "flangeWidth": {
            "type": "number",
            "description": "Flange width of a structural section. Populated for\n`Structural_Channel` and `Structural_IBeam`; null otherwise.",
            "format": "double",
            "nullable": true
          },
          "flangeThickness": {
            "type": "number",
            "description": "Reserved for future use. Not currently populated by any subtype.",
            "format": "double",
            "nullable": true
          }
        }
      },
      "ConnectEnvelopeOfLinearNestingOutputResponse": {
        "type": "object",
        "description": "Standard response wrapper for every Stella Connect endpoint. Successful responses\npopulate Data; failures populate Errors.\nList responses additionally populate Paging.",
        "additionalProperties": false,
        "properties": {
          "data": {
            "nullable": true,
            "$ref": "#/components/schemas/LinearNestingOutputResponse"
          },
          "errors": {
            "type": "array",
            "description": "One or more errors describing why the request failed. Absent (`null`) on success.",
            "nullable": true,
            "items": {
              "$ref": "#/components/schemas/ConnectApiError"
            }
          },
          "paging": {
            "description": "Paging metadata for list endpoints. Absent on single-item responses.",
            "nullable": true,
            "$ref": "#/components/schemas/Paging"
          }
        }
      },
      "LinearNestingOutputResponse": {
        "type": "object",
        "description": "Result of a linear-nesting calculation: which parts landed on which stock\nbars, and how much of each stock was consumed.",
        "additionalProperties": false,
        "properties": {
          "nestingId": {
            "type": "string",
            "description": "Server-generated identifier for this nesting result. Pass it to\n`RenderLinearNest3D` to render the layout as an image.",
            "format": "guid"
          },
          "parts": {
            "type": "array",
            "description": "Per-part summary: one entry per distinct requested part length.",
            "items": {
              "$ref": "#/components/schemas/NestedPartResponse"
            }
          },
          "stock": {
            "type": "array",
            "description": "Per-stock-variant layout: one entry per distinct stock length. Each entry\ndescribes how one bar of that variant is cut, and how many bars were used.",
            "items": {
              "$ref": "#/components/schemas/StockLayoutResponse"
            }
          }
        }
      },
      "NestedPartResponse": {
        "type": "object",
        "description": "Summary of one distinct part length across the whole nesting: how many were\nplaced, how much stock was consumed on its behalf, and its material weight.",
        "additionalProperties": false,
        "properties": {
          "partId": {
            "type": "string",
            "description": "Echo of the caller-supplied `Parts[].PartId` from the request when\none was provided; otherwise a server-generated id. See remarks on\nLinearNestingOutputResponse.",
            "format": "guid"
          },
          "name": {
            "type": "string",
            "description": "Echo of the caller-supplied `Parts[].PartName` from the request.\nNull when the request did not supply one."
          },
          "length": {
            "type": "number",
            "description": "The requested cut length, restated in the request's output length unit.\nSend a 30 mm part on an inch nest and this reads `1.1811`, not\n`30`.",
            "format": "double"
          },
          "lengthUnit": {
            "type": "string",
            "description": "The request's output length unit — not the unit the part was submitted\nin. Matches LengthUnit."
          },
          "quantity": {
            "type": "integer",
            "description": "Echo of the requested quantity. Compare against\nTotalItemsNested to detect a shortfall when stock was\nexhausted before all pieces could be placed.",
            "format": "int32"
          },
          "totalItemsNested": {
            "type": "integer",
            "description": "Actual number of pieces placed across all stock bars. Equals\nQuantity when stock was sufficient; less when it was not.",
            "format": "int32"
          },
          "totalNestedLength": {
            "type": "number",
            "description": "This part's proportional share of total stock length consumed —\n`TotalStockLengthUsed × (this part's summed length / all parts' summed length)`.\nIncludes kerf and chuck allocated to this part; not simply\n`Length × TotalItemsNested`.",
            "format": "double"
          },
          "totalNestedWeight": {
            "type": "number",
            "description": "This part's proportional share of total stock weight consumed\n(same length-ratio allocation as TotalNestedLength).\nIncludes waste (kerf + chuck) attributed to this part.",
            "format": "double"
          },
          "totalTrueWeight": {
            "type": "number",
            "description": "Net material weight of the finished cut pieces for this part —\n`Length × TotalItemsNested × WeightPerLength`. Excludes all waste.\nDifference from TotalNestedWeight is the waste share\nattributed to this part.",
            "format": "double"
          }
        }
      },
      "StockLayoutResponse": {
        "type": "object",
        "description": "Layout for one distinct stock length: how one bar is cut, how many bars of\nthis length were used, and totals across all of them.",
        "additionalProperties": false,
        "properties": {
          "stockId": {
            "type": "string",
            "description": "Server-generated identifier for this stock variant. The request DTO\ndoes not accept caller-supplied stock ids.",
            "format": "guid"
          },
          "keepRemnant": {
            "type": "boolean",
            "description": "Effective remnant decision for this layout: `true` when the leftover\npiece met the request's NestingRemnantPolicy\nthresholds and was kept; `false` when it was discarded (and the whole\nbar was billed as consumed)."
          },
          "numberOfPartsPerUnit": {
            "type": "integer",
            "description": "Total number of parts placed on **one** bar of this variant. Same for\nevery bar of the variant, since all use the same layout.",
            "format": "int32"
          },
          "numberOfUnits": {
            "type": "integer",
            "description": "How many bars of this variant were consumed by the nesting.",
            "format": "int32"
          },
          "totalStockLength": {
            "type": "number",
            "description": "Total raw stock length allocated for this variant —\n`UnitStockLength × NumberOfUnits`. \"What went in.\"",
            "format": "double"
          },
          "totalStockLengthUsed": {
            "type": "number",
            "description": "Total consumed stock length. When KeepRemnant is `true`,\nthis is `(parts + chuck + one kerf) × NumberOfUnits` and the remainder\nis returned to inventory. When `false`, this equals\nTotalStockLength (the whole bar is charged).",
            "format": "double"
          },
          "totalStockWeight": {
            "type": "number",
            "description": "Weight of TotalStockLength at the product's\n`WeightPerLength`.",
            "format": "double"
          },
          "totalStockWeightUsed": {
            "type": "number",
            "description": "Weight of TotalStockLengthUsed at the product's\n`WeightPerLength`.",
            "format": "double"
          },
          "unitStockLength": {
            "type": "number",
            "description": "Length of one raw bar of this variant.",
            "format": "double"
          },
          "unitStockLengthUsed": {
            "type": "number",
            "description": "Consumed length of one bar. Same remnant conditional as\nTotalStockLengthUsed.",
            "format": "double"
          },
          "unitStockWeight": {
            "type": "number",
            "description": "Weight of one raw bar.",
            "format": "double"
          },
          "unitStockWeightUsed": {
            "type": "number",
            "description": "Weight of the consumed portion of one bar.",
            "format": "double"
          },
          "lengthUnit": {
            "type": "string",
            "description": "Length unit used for every length field on this layout and in\nParts."
          },
          "weightUnit": {
            "type": "string",
            "description": "Weight unit used for every weight field on this layout."
          },
          "parts": {
            "type": "array",
            "description": "Parts placed on one bar of this variant. `Quantity` is **per-bar**;\nmultiply by NumberOfUnits for the aggregate count.",
            "items": {
              "$ref": "#/components/schemas/StockPartResponse"
            }
          }
        }
      },
      "StockPartResponse": {
        "type": "object",
        "description": "One kind of part placed on one bar of a stock variant.",
        "additionalProperties": false,
        "properties": {
          "partId": {
            "type": "string",
            "description": "The PartId this row corresponds to.",
            "format": "guid"
          },
          "quantity": {
            "type": "integer",
            "description": "Count of that part placed on a single bar of the owning stock variant.\nMultiply by the layout's NumberOfUnits\nfor the aggregate count.",
            "format": "int32"
          }
        }
      },
      "LinearNestingRequest": {
        "type": "object",
        "description": "Request for the linear-nesting endpoint. Describes what to cut, what stock is\navailable, the material's per-length weight, and the saw's chuck / kerf\nallowances. The engine solves a 1D bin-packing problem — placing part lengths\nonto stock bars to minimize waste.",
        "additionalProperties": false,
        "required": [
          "parts",
          "product",
          "stock",
          "outputLengthUnit"
        ],
        "properties": {
          "parts": {
            "type": "array",
            "description": "Cut requirements: one entry per distinct part length + quantity.",
            "minLength": 1,
            "nullable": false,
            "items": {
              "$ref": "#/components/schemas/NestingPartItem"
            }
          },
          "product": {
            "description": "The material grade being cut. Supplies weight-per-length so the\ntotal weight of cut pieces and stock consumed can be reported.",
            "nullable": false,
            "$ref": "#/components/schemas/NestingProduct"
          },
          "stock": {
            "type": "array",
            "description": "Available raw-stock bars: one entry per distinct stock length + quantity,\neach with its own remnant-keeping policy.",
            "minLength": 1,
            "nullable": false,
            "items": {
              "$ref": "#/components/schemas/NestingStockItem"
            }
          },
          "options": {
            "description": "Machine allowances (chuck at bar start, kerf per cut).\nMay be null; both allowances then default to 0.",
            "$ref": "#/components/schemas/NestingLinearOptions"
          },
          "outputLengthUnit": {
            "type": "string",
            "description": "Length unit to use for all length values in the response.\nDefault: `\"Inch\"`. Must be a recognised length-unit name.",
            "minLength": 1,
            "nullable": false
          }
        }
      },
      "NestingPartItem": {
        "type": "object",
        "description": "A single cut requirement: how many copies of a specific length are needed.",
        "additionalProperties": false,
        "properties": {
          "partId": {
            "type": "string",
            "description": "Opaque caller-supplied correlation id, echoed on the corresponding\n`Parts[].PartId` and on every matching `Stock[].Parts[].PartId`\nin the response. Never resolved against any stored part — if you need the\nnester to derive cut length from an imported part, use the\n`linear-part-lookup` endpoint instead. If omitted (or\nEmpty), the server generates one per row; duplicates\nacross rows in the same request are rejected.",
            "format": "guid",
            "nullable": true
          },
          "partName": {
            "type": "string",
            "description": "Free-form display name echoed back on the corresponding\n`Parts[].Name` in the response. Not interpreted by the nester."
          },
          "length": {
            "type": "number",
            "description": "Length of one cut piece, expressed in LengthUnit.",
            "format": "double"
          },
          "lengthUnit": {
            "type": "string",
            "description": "Length unit for Length (e.g. `\"Inch\"`, `\"Millimeter\"`)."
          },
          "quantity": {
            "type": "integer",
            "description": "How many copies of this length are required.",
            "format": "int32"
          }
        }
      },
      "NestingProduct": {
        "type": "object",
        "description": "Identifies the material grade of the stock being cut. Only per-length weight\nis currently used.",
        "additionalProperties": false,
        "properties": {
          "name": {
            "type": "string",
            "description": "Display name of the product (e.g. `\"HSS 2x2x1/4 A500-B\"`)."
          },
          "weightPerLength": {
            "type": "number",
            "description": "Weight of the product per unit of length. Combined with the layout's\nstock length to compute weight totals in the response.",
            "format": "double"
          },
          "weightPerLengthUnit": {
            "type": "string",
            "description": "Unit for WeightPerLength (e.g. `\"PoundPerFoot\"`)."
          }
        }
      },
      "NestingStockItem": {
        "type": "object",
        "description": "One available raw-stock bar type: a length + how many are on hand + how any\nleftover piece should be handled.",
        "additionalProperties": false,
        "properties": {
          "length": {
            "type": "number",
            "description": "Length of one stock bar, expressed in LengthUnit.",
            "format": "double"
          },
          "lengthUnit": {
            "type": "string",
            "description": "Length unit for Length."
          },
          "quantity": {
            "type": "integer",
            "description": "How many bars of this length are available. Null means unlimited.",
            "format": "int32",
            "nullable": true
          },
          "remnantPolicy": {
            "description": "Rules for whether to keep the leftover piece from each bar (a \"remnant\")\nor discard it.",
            "$ref": "#/components/schemas/NestingRemnantPolicy"
          }
        }
      },
      "NestingRemnantPolicy": {
        "type": "object",
        "description": "Whether the leftover piece from a cut stock bar (a \"remnant\") is worth\nreturning to inventory. If the remnant is shorter or lighter than the\nspecified minimums, it is discarded (and its stock is billed as fully consumed).",
        "additionalProperties": false,
        "properties": {
          "keepRemnant": {
            "type": "boolean",
            "description": "If `false`, remnants are never kept — the entire bar counts as\nconsumed. If `true`, remnants are kept only when they meet\nMinimumLength and/or MinimumWeight."
          },
          "minimumLength": {
            "type": "number",
            "description": "Minimum remnant length worth keeping. Ignored when\nKeepRemnant is `false` or when null.",
            "format": "double",
            "nullable": true
          },
          "lengthUnit": {
            "type": "string",
            "description": "Unit for MinimumLength."
          },
          "minimumWeight": {
            "type": "number",
            "description": "Minimum remnant weight worth keeping. Ignored when\nKeepRemnant is `false` or when null.",
            "format": "double",
            "nullable": true
          },
          "weightUnit": {
            "type": "string",
            "description": "Unit for MinimumWeight."
          }
        }
      },
      "NestingLinearOptions": {
        "type": "object",
        "description": "Machine allowances. Values default to 0 when null.",
        "additionalProperties": false,
        "properties": {
          "chuck": {
            "type": "number",
            "description": "Chuck / grip allowance at the start of every stock bar — length that\ncannot be cut because it is held in the saw's chuck.",
            "format": "double",
            "nullable": true
          },
          "chuckUnit": {
            "type": "string",
            "description": "Unit for Chuck."
          },
          "kerf": {
            "type": "number",
            "description": "Kerf allowance — width of material the saw blade removes on each cut.",
            "format": "double",
            "nullable": true
          },
          "kerfUnit": {
            "type": "string",
            "description": "Unit for Kerf."
          }
        }
      },
      "LinearNestingPartLookupRequest": {
        "type": "object",
        "description": "Request for the linear-nesting-by-lookup endpoint. Same shape as\nLinearNestingRequest, but parts are identified by\n`PartId` (a previously imported part) instead of by explicit length —\neach part is classified inline and uses the resulting cut length.",
        "additionalProperties": false,
        "required": [
          "parts",
          "product",
          "stock",
          "outputLengthUnit",
          "outputTimeUnit",
          "outputWeightUnit"
        ],
        "properties": {
          "parts": {
            "type": "array",
            "description": "Cut requirements identified by `PartId` + quantity. Each id must\nresolve to an imported part; the part is classified inline (no prior\ncall to the classification endpoint is required). Parts that cannot be\nclassified as linear cause the whole request to fail.",
            "minLength": 1,
            "nullable": false,
            "items": {
              "$ref": "#/components/schemas/NestingPartLookupItem"
            }
          },
          "product": {
            "description": "The material grade being cut. Supplies weight-per-length so\nthe total weight of cut pieces and stock consumed can be reported.",
            "nullable": false,
            "$ref": "#/components/schemas/NestingProduct"
          },
          "stock": {
            "type": "array",
            "description": "Available raw-stock bars: one entry per distinct stock length + quantity,\neach with its own remnant-keeping policy.",
            "minLength": 1,
            "nullable": false,
            "items": {
              "$ref": "#/components/schemas/NestingStockItem"
            }
          },
          "options": {
            "description": "Machine allowances (chuck at bar start, kerf per cut).\nMay be null; both allowances then default to 0.",
            "$ref": "#/components/schemas/NestingLinearOptions"
          },
          "outputLengthUnit": {
            "type": "string",
            "description": "Length unit to use for all length values in the response.\nDefault: `\"Inch\"`. Must be a recognised length-unit name.",
            "minLength": 1,
            "nullable": false
          },
          "outputTimeUnit": {
            "type": "string",
            "description": "Reserved. Currently ignored — the response always uses `\"Minute\"`.",
            "minLength": 1,
            "nullable": false
          },
          "outputWeightUnit": {
            "type": "string",
            "description": "Reserved. Currently ignored — the response always uses `\"Pound\"`.",
            "minLength": 1,
            "nullable": false
          }
        }
      },
      "NestingPartLookupItem": {
        "type": "object",
        "description": "A single cut requirement identified by an imported part id + quantity.\nThe id is used to obtain the part's classified cut length.",
        "additionalProperties": false,
        "properties": {
          "partId": {
            "type": "string",
            "description": "Identifier of an imported part to include in the nesting. Classification\nis performed inline — the part need not have been classified beforehand,\nbut it must be classifiable as linear.",
            "format": "guid"
          },
          "quantity": {
            "type": "integer",
            "description": "How many copies of this part are required.",
            "format": "int32"
          }
        }
      },
      "ConnectEnvelopeOfRenderLinearNestResponse": {
        "type": "object",
        "description": "Standard response wrapper for every Stella Connect endpoint. Successful responses\npopulate Data; failures populate Errors.\nList responses additionally populate Paging.",
        "additionalProperties": false,
        "properties": {
          "data": {
            "nullable": true,
            "$ref": "#/components/schemas/RenderLinearNestResponse"
          },
          "errors": {
            "type": "array",
            "description": "One or more errors describing why the request failed. Absent (`null`) on success.",
            "nullable": true,
            "items": {
              "$ref": "#/components/schemas/ConnectApiError"
            }
          },
          "paging": {
            "description": "Paging metadata for list endpoints. Absent on single-item responses.",
            "nullable": true,
            "$ref": "#/components/schemas/Paging"
          }
        }
      },
      "RenderLinearNestResponse": {
        "type": "object",
        "description": "Response payload for the render-linear-nest endpoint. Returned inside a\n`ConnectEnvelope<RenderLinearNestResponse>`.",
        "additionalProperties": false,
        "properties": {
          "nestId": {
            "type": "string",
            "description": "Echo of the `NestId` that was rendered.",
            "format": "guid"
          },
          "imageData": {
            "type": "string",
            "description": "Rendered image, base64-encoded. Decode to bytes and interpret according to\nthe requested `ImageType` (PNG or SVG)."
          }
        }
      },
      "RenderLinearNestRequest": {
        "type": "object",
        "description": "Request for the linear-nest render endpoint. Combines a path-bound\nNestId with body-bound image and per-element styling options.",
        "additionalProperties": false,
        "properties": {
          "imageType": {
            "description": "Output image format. Default: `Png`.",
            "$ref": "#/components/schemas/ImageTypeRequest"
          },
          "imageWidth": {
            "type": "integer",
            "description": "Width of the rendered image in pixels. Must be greater than 0. Default: `1280`.",
            "format": "int32",
            "minimum": 0,
            "nullable": true,
            "exclusiveMinimum": true
          },
          "imageHeight": {
            "type": "integer",
            "description": "Height of the rendered image in pixels. Must be greater than 0. Default: `1024`.",
            "format": "int32",
            "minimum": 0,
            "nullable": true,
            "exclusiveMinimum": true
          },
          "chuck": {
            "description": "Styling for the chuck region drawn at the start of every stock bar.",
            "$ref": "#/components/schemas/NestRenderingOptions"
          },
          "kerf": {
            "description": "Styling for the kerf (saw-blade waste) drawn between adjacent parts.",
            "$ref": "#/components/schemas/NestRenderingOptions"
          },
          "part": {
            "description": "Styling for the part bodies laid on each stock bar.",
            "$ref": "#/components/schemas/NestRenderingOptions"
          },
          "remnant": {
            "description": "Styling for the remnant region left after the final cut on each stock bar.",
            "$ref": "#/components/schemas/NestRenderingOptions"
          }
        }
      },
      "ImportFiles3DRequest": {
        "type": "object",
        "description": "Request body for `POST /v2/3d/files/import`. Uploads one or more 3D CAD files\nand extracts each part contained within them.",
        "additionalProperties": false,
        "required": [
          "files"
        ],
        "properties": {
          "files": {
            "type": "array",
            "description": "One or more CAD files to import. See the endpoint description for supported\nformats. A single file may contain multiple parts; separate closed contours are\nextracted as distinct parts.",
            "minLength": 1,
            "nullable": false,
            "items": {
              "type": "string",
              "format": "binary"
            }
          },
          "unfold": {
            "type": "boolean",
            "description": "When `true`, sheet-metal parts are unfolded during import so downstream\nendpoints see the flat pattern. Default: `false`."
          }
        }
      },
      "ConnectEnvelopeOfIEnumerableOfOrder": {
        "type": "object",
        "description": "Standard response wrapper for every Stella Connect endpoint. Successful responses\npopulate Data; failures populate Errors.\nList responses additionally populate Paging.",
        "additionalProperties": false,
        "properties": {
          "data": {
            "type": "array",
            "nullable": true,
            "items": {
              "$ref": "#/components/schemas/Order"
            }
          },
          "errors": {
            "type": "array",
            "description": "One or more errors describing why the request failed. Absent (`null`) on success.",
            "nullable": true,
            "items": {
              "$ref": "#/components/schemas/ConnectApiError"
            }
          },
          "paging": {
            "description": "Paging metadata for list endpoints. Absent on single-item responses.",
            "nullable": true,
            "$ref": "#/components/schemas/Paging"
          }
        }
      },
      "Order": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "orderId": {
            "type": "string",
            "description": "Unique identifier for the order in Stella"
          },
          "quoteNumber": {
            "type": "string",
            "description": "Quote/order number as it appears in Stella"
          },
          "poNumber": {
            "type": "string",
            "description": "Purchase order number as entered by the purchaser"
          },
          "orderNumber": {
            "type": "string",
            "description": "Order number entered by the supplier when the contract was signed"
          },
          "quoteCreatedDate": {
            "type": "string",
            "description": "Date the original quote was created",
            "format": "date-time"
          },
          "orderPlacedDate": {
            "type": "string",
            "description": "Date the purchaser placed the order",
            "format": "date-time"
          },
          "orderAcceptedDate": {
            "type": "string",
            "description": "Date the supplier accepted the order",
            "format": "date-time"
          },
          "status": {
            "description": "Current status of the order in the quoting/ordering workflow",
            "$ref": "#/components/schemas/QuoteRequestStatus"
          },
          "totalPrice": {
            "type": "number",
            "description": "Total order price including all charges and taxes",
            "format": "decimal"
          },
          "subTotalPrice": {
            "type": "number",
            "description": "Subtotal before tax and miscellaneous charges",
            "format": "decimal"
          },
          "salesTax": {
            "type": "number",
            "description": "Sales tax amount applied to the order",
            "format": "decimal"
          },
          "miscellaneousCharges": {
            "type": "array",
            "description": "Collection of additional charges applied to the order (e.g., freight, setup fees)",
            "items": {
              "$ref": "#/components/schemas/MiscellaneousCost"
            }
          },
          "shippingMethod": {
            "type": "string",
            "description": "Freight/shipping method selected for the order"
          },
          "estimatedDeliveryDate": {
            "type": "string",
            "description": "Estimated date the order will be delivered",
            "format": "date-time"
          },
          "totalQuantity": {
            "type": "number",
            "description": "Total quantity of all line items combined",
            "format": "decimal"
          },
          "supplierNotes": {
            "type": "string",
            "description": "Notes added by the supplier on the order"
          },
          "poNotes": {
            "type": "string",
            "description": "Purchase order notes as entered by the purchaser"
          },
          "lines": {
            "type": "array",
            "description": "Collection of line items in the order",
            "items": {
              "$ref": "#/components/schemas/OrderLineItem"
            }
          },
          "supplierLocationName": {
            "type": "string",
            "description": "Name of the supplier location fulfilling the order"
          },
          "acknowledgedBy": {
            "type": "string",
            "description": "Name or identifier of the person who acknowledged the order"
          },
          "customer": {
            "description": "Customer contact and address information for this order",
            "$ref": "#/components/schemas/Customer"
          }
        }
      },
      "QuoteRequestStatus": {
        "type": "string",
        "description": "",
        "x-enumNames": [
          "InProgress",
          "AwaitingResponse",
          "Closed",
          "Acknowledged",
          "Applied",
          "Awarded",
          "Rejected",
          "OrderPending",
          "OrderAbandoned",
          "OrderConfirmed",
          "OrderDeclined",
          "OrderInvoiced",
          "Expired"
        ],
        "enum": [
          "InProgress",
          "AwaitingResponse",
          "Closed",
          "Acknowledged",
          "Applied",
          "Awarded",
          "Rejected",
          "OrderPending",
          "OrderAbandoned",
          "OrderConfirmed",
          "OrderDeclined",
          "OrderInvoiced",
          "Expired"
        ]
      },
      "MiscellaneousCost": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "name": {
            "type": "string",
            "description": "Display name of the miscellaneous charge (e.g., \"Freight\", \"Setup Fee\")"
          },
          "amount": {
            "type": "number",
            "description": "Amount of the charge in the order currency",
            "format": "decimal"
          }
        }
      },
      "OrderLineItem": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "lineItemKey": {
            "type": "string",
            "description": "Unique identifier for the line item",
            "format": "guid"
          },
          "description": {
            "type": "string",
            "description": "Human-readable description of the line item"
          },
          "quantity": {
            "type": "integer",
            "description": "Quantity ordered",
            "format": "int32"
          },
          "lineType": {
            "type": "string",
            "description": "Type of line item (e.g., \"part\", \"material\", \"service\")"
          },
          "notes": {
            "type": "string",
            "description": "Additional notes or instructions for the line item"
          },
          "unitPrice": {
            "type": "number",
            "description": "Price per unit in the order currency",
            "format": "decimal"
          },
          "totalPrice": {
            "type": "number",
            "description": "Total price for the line item (unit price × quantity)",
            "format": "decimal"
          },
          "unitWeight": {
            "type": "number",
            "description": "Weight of a single unit",
            "format": "decimal"
          },
          "totalWeight": {
            "type": "number",
            "description": "Total weight for all units (unit weight × quantity)",
            "format": "decimal"
          },
          "sku": {
            "type": "string",
            "description": "Stock keeping unit identifier for the line item, if applicable",
            "nullable": true
          }
        }
      },
      "Customer": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "company": {
            "type": "string",
            "description": "Name of the purchasing company"
          },
          "locationName": {
            "type": "string",
            "description": "Name of the purchasing location"
          },
          "purchasedBy": {
            "type": "string",
            "description": "Name of the person who placed the order"
          },
          "email": {
            "type": "string",
            "description": "Email address of the purchaser contact"
          },
          "phone": {
            "type": "string",
            "description": "Phone number of the purchaser contact"
          },
          "location": {
            "description": "Physical address of the purchasing location",
            "$ref": "#/components/schemas/Location"
          }
        }
      },
      "Location": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "externalId": {
            "type": "string",
            "description": "External ERP identifier for this location, if set",
            "nullable": true
          },
          "addressLine1": {
            "type": "string",
            "description": "Street address line 1"
          },
          "addressLine2": {
            "type": "string",
            "description": "Street address line 2, if provided",
            "nullable": true
          },
          "locality": {
            "type": "string",
            "description": "City or locality"
          },
          "stateOrProvince": {
            "type": "string",
            "description": "State or province"
          },
          "postalCode": {
            "type": "string",
            "description": "Postal or ZIP code"
          },
          "country": {
            "type": "string",
            "description": "Country code"
          }
        }
      },
      "UpdateProductCostsRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "productCosts"
        ],
        "properties": {
          "productCosts": {
            "type": "array",
            "minLength": 1,
            "nullable": false,
            "items": {
              "$ref": "#/components/schemas/ProductCostRequest"
            }
          }
        }
      },
      "ProductCostRequest": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "cost": {
            "type": "number",
            "format": "decimal"
          },
          "costUnitOfMeasure": {
            "$ref": "#/components/schemas/CostUnits"
          },
          "supplierProductId": {
            "type": "string"
          }
        }
      },
      "CostUnits": {
        "type": "string",
        "description": "",
        "x-enumNames": [
          "lb"
        ],
        "x-enum-descriptions": [
          "Cost per pound"
        ],
        "enum": [
          "lb"
        ],
        "x-enumDescriptions": {
          "lb": "Cost per pound"
        }
      },
      "UpdateProductLimitsRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "productLimits"
        ],
        "properties": {
          "productLimits": {
            "type": "array",
            "minLength": 1,
            "nullable": false,
            "items": {
              "$ref": "#/components/schemas/ProductLimitsRequest"
            }
          }
        }
      },
      "ProductLimitsRequest": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "productLimit": {
            "type": "number",
            "format": "decimal"
          },
          "productLimitUnitOfMeasure": {
            "$ref": "#/components/schemas/LimitUnits"
          },
          "supplierProductId": {
            "type": "string"
          }
        }
      },
      "LimitUnits": {
        "type": "string",
        "description": "",
        "x-enumNames": [
          "lb",
          "unit"
        ],
        "x-enum-descriptions": [
          "Limits will be applied by the weight of product purchased",
          "Limits will be applied by the quantity of product purchased"
        ],
        "enum": [
          "lb",
          "unit"
        ],
        "x-enumDescriptions": {
          "lb": "Limits will be applied by the weight of product purchased",
          "unit": "Limits will be applied by the quantity of product purchased"
        }
      }
    },
    "securitySchemes": {
      "apikey": {
        "type": "apiKey",
        "name": "x-api-key",
        "in": "header"
      }
    }
  },
  "servers": [
    {
      "url": "https://connect.stellasource.com"
    }
  ]
}
