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.
Showing all 59 changes
All 59 changes
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
partIdandpartNameon each entry inparts. The response echoes them back aspartIdandnameso you can match results to your own parts. DuplicatepartIdvalues in one request are rejected with a 400. Without apartIdthe 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
supplierProductIdandproductLimitUnitas 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
nullentry inpartsorstockon 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
- 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_2Dis 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
salesTaxAmountandmiscellaneousCosts(a map of cost description to amount).
2026-10-06
- v0.1-alpha Changed
ImportParts rejects an empty
fileslist 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_requiredorcost_invalid(negative cost). UpdateProductLimits returnsproduct_limits_required,supplier_product_id_requiredorproduct_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 (
imageTypemust be png, svg or pdf) and ImportFile (filesmust not be empty). Requests that were previously accepted with invalid values are now rejected with a 400. - v1.0 Changed
ListOrders validates paging input:
limitmust be between 1 and 250 (error idlimit_invalid) andstartis a 1-based page number of at least 1 (error idstart_invalid). - v1.0 Fixed
RenderLinearNest and RenderPlanarNest answer 404 with error id
NestNotFoundwhen no nest matches the suppliedNestId. - v2.0 Changed
PlanarPartsNesting2D answers 422 with error id
part_not_nestablewhen a part is still 3D or has no closed outline, instead of a 500nesting_failed. APartIdthat was never imported now answers 404 with error idpart_not_found, also instead of a 500nesting_failed. - v2.0 Changed
The v2 product cost and limit operations (UpdateProductCostsV2 and UpdateProductLimitsV2) reject empty lists, an empty
supplierProductId, and a negativecostwith a 400 (product_costs_required,product_limits_required,supplier_product_id_required,cost_invalid). The 3D file import also rejects an emptyfileslist 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
startTimebefore paging, sototal,limitandstartin 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
lengthUsedandwidthUsed, the extent of the material actually consumed. They equal the sheetlengthandwidthunless a remnant was kept.
2026-08-10
- v2.0 Added
Errors from the v2 operations carry a stable
errorIdyou 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_foundandinternal_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 keep403Forbiddenand422SupplierId. - v2.0 Changed
The classification
dimensionschanged. Linear classification:areaandoutsideAreaare removed, anddimensionsnow hassurfaceArea,internalSurfaceArea,crossSectionalSurfaceAreaandvolume, plusoutsideSurfaceAreaandinsideSurfaceAreawhen they apply to the profile. Planar classification:areais nowsurfaceAreawith a newfullSurfaceArea,outsideAreais removed, andinternalSurfaceAreaandvolumeare 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,productLimitandproductLimitUnitOfMeasure(lbto limit by weight,unitto 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,costandcostUnitOfMeasure(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 theproductIdof 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 theproductIdof the sheets in the response is no longer populated. - v1.0 Changed
PlanarNestMultipleParts answers a unit conversion failure with error id
unit_conversion_errorand the reason instead oferror. - v2.0 Added
The 3D file import takes an optional
unfoldflag that unfolds sheet-metal parts during import. Planar part classification reportsbendCount. - v2.0 Changed
Classification responses identify the part by
partId(results previously usedidandfileId). Planar classification reportscutLengthinstead ofperimeter, addslengthand drops the deprecateddepth. Parts in the 2D and 3D import responses are identified bypartIdinstead ofpartFileIdand no longer includedimensionality. 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
outputTimeUnitandoutputWeightUnit(the part lookup variant still does), and the planar nesting request no longer takesproductIdormaterialTypeon the sheet. Sheets in the planar nesting response no longer includematerialType, and theirproductIdis no longer filled in. - v2.0 Removed
The
planar-unfoldandlinear-unfoldclassification operations, the 3D planar classification, the 3D planar nesting and the 3D planar nest rendering operations. Use theunfoldoption 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
MiscItemas theprocessof buyout lines. - v1.0 Changed
In orders returned by ListOrders, the
notesof an order line now come from the supplier's response line, andfreightfalls 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-unfoldfor 2D parts,linear-unfoldandplanar-unfoldfor 3D parts) that reportbendCount. They were later replaced by theunfoldoption of the 3D file import.
2026-04-30
- v2.0 Added
RenderPlanarNest2D,
RenderPlanarNest3Dand RenderLinearNest3D render a nest created by the v2 nesting operations to images.
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,outputTimeUnitandoutputWeightUnit, which set the units of the lengths, times and weights in the response. An unsupported unit is rejected with a 400. - v2.0 Changed
2026-04-27
- v1.0 Added
Each location returned by ListCompanyLocations includes its
alias.
2026-04-25
- v2.0 Changed
Linear part classification no longer returns
depth,perimeter,rectangularArea,thicknessorwidthindimensions. It returnscontoursinstead, andcrossSectionalDimensionsadds the named values that apply to the profile (size,height,width,diameter,outsideDiameter,insideDiameter,wallThickness,thickness,webThickness,flangeWidth,flangeThickness). - v2.0 Deprecated
depthin thedimensionsof planar classification. Usethickness.
2026-04-16
- v1.0 Removed
The
secturafaboperations:GetQuoteByID,GetQuotesByStatus,CreateContactsandCreateOrganizations.
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
V2or the underscore, for exampleImportFilesV2_2Dis now ImportFiles2D andLinearPartsNesting_3Dis now LinearPartsNesting3D. The routes are unchanged, but clients generated from the spec get the new names.
2026-03-31
- v2.0 Added
Nesting operations for 3D parts: linear nesting, linear nesting from a part lookup and planar nesting.
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
- v2.0 Added
- v2.0 Added
- v2.0 Added
Part classification for 2D planar parts (PlanarPartsClassification2D) and for 3D linear (LinearPartsClassification3D) and planar parts.