Skip to content
Stella ConnectDocs

Stella Connect release notes

Changes to the Stella Connect API listed by release date, version number, and change type. Dates are when each change became available in production.

2026-11-13

  • v1.0 Changed

    ListCompanyLocations and ListOrders can answer 403 Forbidden when the request is authenticated but not allowed to call the operation.

  • v2.0 Changed

    The file, part, classification, nesting and render v2 operations can answer 403 Forbidden when the request is authenticated but not allowed to call the operation.

2026-11-12

  • v2.0 Added

    Nest linear parts onto stock bars accepts an optional partId and partName on each entry in parts. The response echoes them back as partId and name so you can match results to your own parts. Duplicate partId values in one request are rejected with a 400. Without a partId the server still generates one per row.

  • v2.0 Added

    List completed orders is now available. It returns a paginated list of completed orders with pricing totals, miscellaneous charges, shipping method and a structured customer block.

2026-11-04

  • v1.0 Fixed

    The documentation now marks supplierProductId and productLimitUnit as required on each item of UpdateProductLimits. Requests that omit them were already rejected with a 400 (see the 2026-10-06 entry), so nothing changes for working integrations.

  • v2.0 Fixed

    A null entry in parts or stock on the linear nesting operations (nest linear parts onto stock bars and nest linear parts using a part lookup) is now rejected with a 400 validation error.

2026-10-27

  • v0.1-alpha Changed

    ImportParts answers 413 with the standard error body when the upload exceeds the maximum request size, instead of a generic 500.

  • v0.1-alpha Changed

    A request to any v0.1-alpha operation with a malformed or truncated body is answered with a 400 and the standard error body instead of a generic 500.

  • v1.0 Changed

    ImportFile, CreateBatchInvoices and ImportPart answer 413 with the standard error body when the upload exceeds the maximum request size, instead of a generic 500.

  • v1.0 Changed

    A request to any v1.0 operation with a malformed or truncated body is answered with a 400 and the standard error body instead of a generic 500.

  • v2.0 Changed

    The 2D and 3D file import operations answer 413 with the standard error body when the upload exceeds the maximum request size, instead of a generic 500.

  • v2.0 Changed

    A request to any v2.0 operation with a malformed or truncated body is answered with a 400 and the standard error body instead of a generic 500.

2026-10-19

  • v2.0 Changed

    The 2D file import accepts only DXF and DWG. The 3D file import rejects 2D files (DXF, DWG) and PDF. A file sent to the wrong import operation is rejected with a 400 that names the correct one.

  • v2.0 Changed

    The operation id PlanarPartsClassification_2D is now PlanarPartsClassification2D. The route is unchanged, but clients generated from the spec get the new name.

2026-10-07

  • v1.0 Added

    Orders returned by ListOrders include salesTaxAmount and miscellaneousCosts (a map of cost description to amount).

2026-10-06

  • v0.1-alpha Changed

    ImportParts rejects an empty files list with a 400.

  • v1.0 Changed

    UpdateProductCosts and UpdateProductLimits now reject invalid input with a 400 and a snake_case error id. UpdateProductCosts returns supplier_product_ids_required, supplier_product_id_required, cost_unit_of_measure_required or cost_invalid (negative cost). UpdateProductLimits returns product_limits_required, supplier_product_id_required or product_limit_unit_required. Requests that were previously accepted, such as a negative cost or an empty id, are now rejected.

  • v1.0 Changed

    Input validation was also added to the linear (multiple parts, single part) and planar (multiple parts, single part) nesting operations, RenderFile (imageType must be png, svg or pdf) and ImportFile (files must not be empty). Requests that were previously accepted with invalid values are now rejected with a 400.

  • v1.0 Changed

    ListOrders validates paging input: limit must be between 1 and 250 (error id limit_invalid) and start is a 1-based page number of at least 1 (error id start_invalid).

  • v1.0 Fixed

    RenderLinearNest and RenderPlanarNest answer 404 with error id NestNotFound when no nest matches the supplied NestId.

  • v2.0 Changed

    PlanarPartsNesting2D answers 422 with error id part_not_nestable when a part is still 3D or has no closed outline, instead of a 500 nesting_failed. A PartId that was never imported now answers 404 with error id part_not_found, also instead of a 500 nesting_failed.

  • v2.0 Changed

    The v2 product cost and limit operations (UpdateProductCostsV2 and UpdateProductLimitsV2) reject empty lists, an empty supplierProductId, and a negative cost with a 400 (product_costs_required, product_limits_required, supplier_product_id_required, cost_invalid). The 3D file import also rejects an empty files list with a 400. The v2 linear and planar nesting operations (linear, linear from a part lookup and planar) validate more of their input (parts and sheet sizes, quantities, clearance, remnant units) and answer 400 for invalid values.

2026-10-05

  • v1.0 Fixed

    ListOrders applies startTime before paging, so total, limit and start in the response reflect the filtered results.

2026-09-24

  • v1.0 Fixed

    ListOrders skips an order whose details cannot be assembled instead of failing the whole page with a 500.

2026-09-08

  • v1.0 Added

    Each contact returned by ListContacts includes externalId, your own identifier for the contact, when one is set.

  • v1.0 Added

    Orders returned by ListOrders include purchaserLocationExternalId, your own identifier for the purchaser location, when one is set.

2026-09-02

  • v2.0 Added

    Each sheet in a planar nesting response includes lengthUsed and widthUsed, the extent of the material actually consumed. They equal the sheet length and width unless a remnant was kept.

2026-08-10

  • v2.0 Added

    Errors from the v2 operations carry a stable errorId you can branch on instead of parsing the description: unsupported_file_type, import_failed, file_not_found, render_failed, part_not_found, classification_failed, nesting_failed, nest_not_found and internal_error. New ids may be added, but existing ones are not renamed or removed. This applies to the file, part, nesting and render operations; UpdateProductCostsV2 and UpdateProductLimitsV2 keep 403Forbidden and 422SupplierId.

  • v2.0 Changed

    The classification dimensions changed. Linear classification: area and outsideArea are removed, and dimensions now has surfaceArea, internalSurfaceArea, crossSectionalSurfaceArea and volume, plus outsideSurfaceArea and insideSurfaceArea when they apply to the profile. Planar classification: area is now surfaceArea with a new fullSurfaceArea, outsideArea is removed, and internalSurfaceArea and volume are new.

2026-07-20

  • v1.0 Removed

    Orders returned by ListOrders no longer include purchaserConnectIntegrationId.

2026-07-08

  • v2.0 Added

    UpdateProductLimitsV2 is now available. It updates product limits for several products in one batch. Each item takes supplierProductId, productLimit and productLimitUnitOfMeasure (lb to limit by weight, unit to limit by quantity). It answers 422 when a supplier product id is not found in your catalog and 403 when you cannot access the company location.

2026-07-07

  • v2.0 Added

    UpdateProductCostsV2 is now available. It updates product costs for several products in one batch. Each item takes supplierProductId, cost and costUnitOfMeasure (lb, cost per pound). It answers 422 when a supplier product id is not found in your catalog and 403 when you cannot access the company location.

2026-06-26

  • v0.1-alpha Changed

    CreateNest no longer requires sheetOptions.productId, and the productId of each sheet in the response is a generated id instead of the catalog id.

  • v1.0 Changed

    The planar nesting operations (PlanarNestMultipleParts and PlanarNestSinglePart) no longer forward the sheet productId, and the productId of the sheets in the response is no longer populated.

  • v1.0 Changed

    PlanarNestMultipleParts answers a unit conversion failure with error id unit_conversion_error and the reason instead of error.

  • v2.0 Added

    The 3D file import takes an optional unfold flag that unfolds sheet-metal parts during import. Planar part classification reports bendCount.

  • v2.0 Changed

    Classification responses identify the part by partId (results previously used id and fileId). Planar classification reports cutLength instead of perimeter, adds length and drops the deprecated depth. Parts in the 2D and 3D import responses are identified by partId instead of partFileId and no longer include dimensionality. The classification and render path parameter {PartFileId} is now {PartId} (the URLs are unchanged, but generated clients get the new parameter name).

  • v2.0 Changed

    The linear nesting and planar nesting requests no longer take outputTimeUnit and outputWeightUnit (the part lookup variant still does), and the planar nesting request no longer takes productId or materialType on the sheet. Sheets in the planar nesting response no longer include materialType, and their productId is no longer filled in.

  • v2.0 Removed

    The planar-unfold and linear-unfold classification operations, the 3D planar classification, the 3D planar nesting and the 3D planar nest rendering operations. Use the unfold option of the 3D file import instead of the unfold classification variants.

2026-05-29

  • v1.0 Added

    Orders returned by ListOrders include quoteNumber.

  • v1.0 Changed

    Order lines returned by ListOrders report MiscItem as the process of buyout lines.

  • v1.0 Changed

    In orders returned by ListOrders, the notes of an order line now come from the supplier's response line, and freight falls back to the response's freight requirements when the quote request has none.

  • v1.0 Removed

    Orders returned by ListOrders no longer include customer.

2026-05-06

  • v2.0 Added

    Part classification has unfold variants (planar-unfold for 2D parts, linear-unfold and planar-unfold for 3D parts) that report bendCount. They were later replaced by the unfold option of the 3D file import.

2026-04-30

2026-04-29

  • v2.0 Added

    PlanarPartsNesting2D is now available and nests 2D parts onto sheets.

  • v2.0 Added

    The nesting requests (linear, linear from a part lookup, 3D planar and 2D planar) accept outputLengthUnit, outputTimeUnit and outputWeightUnit, which set the units of the lengths, times and weights in the response. An unsupported unit is rejected with a 400.

  • v2.0 Changed

    The file and part render operations (2D file, 3D file, 2D part and 3D part) return the reason in errors when rendering fails, instead of an empty 400.

2026-04-27

2026-04-25

  • v2.0 Changed

    Linear part classification no longer returns depth, perimeter, rectangularArea, thickness or width in dimensions. It returns contours instead, and crossSectionalDimensions adds the named values that apply to the profile (size, height, width, diameter, outsideDiameter, insideDiameter, wallThickness, thickness, webThickness, flangeWidth, flangeThickness).

  • v2.0 Deprecated

    depth in the dimensions of planar classification. Use thickness.

2026-04-16

  • v1.0 Removed

    The secturafab operations: GetQuoteByID, GetQuotesByStatus, CreateContacts and CreateOrganizations.

2026-04-07

  • v2.0 Changed

    The operation ids of the file import, file render, part render, nesting and 3D classification operations no longer carry V2 or the underscore, for example ImportFilesV2_2D is now ImportFiles2D and LinearPartsNesting_3D is now LinearPartsNesting3D. The routes are unchanged, but clients generated from the spec get the new names.

2026-03-31

2026-03-20

  • v1.0 Added

    ImportFile imports one or more CAD files and returns the parts extracted from them.

  • v1.0 Added

    RenderFile renders an imported file to an image.

2026-03-12