{
  "openapi": "3.1.1",
  "info": {
    "title": "Connect",
    "version": "v1.0"
  },
  "paths": {
    "/v1.0/commerce/company-locations": {
      "get": {
        "tags": [
          "commerce"
        ],
        "summary": "List company locations",
        "description": "Returns all active locations. Use the returned Key values\nas CompanyLocationKey path parameters in downstream contact and product endpoints.",
        "operationId": "ListCompanyLocations",
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeOfListCompanyLocationsResponse"
                }
              }
            }
          },
          "400": {
            "description": "Validation failed or the request was malformed.",
            "content": {
              "application/json": {
                "schema": {
                  "nullable": true,
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          },
          "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": []
          }
        ]
      }
    },
    "/v1.0/commerce/contact-companies/{CompanyLocationKey}": {
      "get": {
        "tags": [
          "commerce"
        ],
        "summary": "List contact companies",
        "description": "Returns all companies in a location's contacts. Pass ContactCompanyKey from these \nresults to ListContactLocations.",
        "operationId": "ListContactCompanies",
        "parameters": [
          {
            "name": "CompanyLocationKey",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "guid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeOfListContactCompaniesResponse"
                }
              }
            }
          },
          "400": {
            "description": "Validation failed or the request was malformed.",
            "content": {
              "application/json": {
                "schema": {
                  "nullable": true,
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "500": {
            "description": "An unexpected error occurred on the server.",
            "content": {
              "application/json": {
                "schema": {
                  "nullable": true,
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          }
        },
        "security": [
          {
            "apikey": []
          }
        ]
      }
    },
    "/v1.0/commerce/contact-locations/{ContactCompanyKey}": {
      "get": {
        "tags": [
          "commerce"
        ],
        "summary": "List contact locations",
        "description": "Returns all locations for a contact company. Pass ContactCompanyLocationKey\nfrom these results to ListContacts.",
        "operationId": "ListContactLocations",
        "parameters": [
          {
            "name": "ContactCompanyKey",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "guid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeOfListContactLocationsResponse"
                }
              }
            }
          },
          "400": {
            "description": "Validation failed or the request was malformed.",
            "content": {
              "application/json": {
                "schema": {
                  "nullable": true,
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "500": {
            "description": "An unexpected error occurred on the server.",
            "content": {
              "application/json": {
                "schema": {
                  "nullable": true,
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          }
        },
        "security": [
          {
            "apikey": []
          }
        ]
      }
    },
    "/v1.0/commerce/contacts/{ContactCompanyLocationKey}": {
      "get": {
        "tags": [
          "commerce"
        ],
        "summary": "List contacts",
        "description": "Returns all contacts at a specific contact company location. The ExternalId on each contact\nreflects any ERP identifier stored via the external ID system.",
        "operationId": "ListContacts",
        "parameters": [
          {
            "name": "ContactCompanyLocationKey",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "guid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeOfListContactsResponse"
                }
              }
            }
          },
          "400": {
            "description": "Validation failed or the request was malformed.",
            "content": {
              "application/json": {
                "schema": {
                  "nullable": true,
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "500": {
            "description": "An unexpected error occurred on the server.",
            "content": {
              "application/json": {
                "schema": {
                  "nullable": true,
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          }
        },
        "security": [
          {
            "apikey": []
          }
        ]
      }
    },
    "/v1.0/commerce/orders": {
      "get": {
        "tags": [
          "commerce"
        ],
        "summary": "List completed orders",
        "description": "Returns a paginated list of invoiced or confirmed orders. Includes header details, supplier \nand purchaser addresses, and line items with pricing and material information.\"",
        "operationId": "ListOrders",
        "parameters": [
          {
            "name": "StartTime",
            "in": "query",
            "description": "Return orders updated/created from 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"
          },
          "403": {
            "description": "Forbidden"
          },
          "500": {
            "description": "An unexpected error occurred on the server.",
            "content": {
              "application/json": {
                "schema": {
                  "nullable": true,
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          }
        },
        "security": [
          {
            "apikey": []
          }
        ]
      }
    },
    "/v1.0/commerce/orders/{OrderId}": {
      "patch": {
        "tags": [
          "commerce"
        ],
        "summary": "Updates order details",
        "description": "Updates the ConnectIntegrationId on an existing order to associate an ERP or external system\nreference. The OrderId is the Stella order identifier returned by ListOrders.",
        "operationId": "UpdateOrderDetails",
        "parameters": [
          {
            "name": "OrderId",
            "in": "path",
            "required": true,
            "description": "Order identifier",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "description": "",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateOrderDetailsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeOfSuccessFailureResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails2"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred on the server.",
            "content": {
              "application/json": {
                "schema": {
                  "nullable": true,
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          }
        },
        "security": [
          {
            "apikey": []
          }
        ]
      }
    },
    "/v1.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": "UpdateProductCosts",
        "parameters": [
          {
            "name": "CompanyLocationKey",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "description": "",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateProductCostsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeOfSuccessFailureResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "422": {
            "description": "",
            "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": []
          }
        ]
      }
    },
    "/v1.0/commerce/product-limits/{CompanyLocationKey}": {
      "put": {
        "tags": [
          "commerce"
        ],
        "summary": "Update product limits",
        "description": "Updates product limits for multiple products in a single batch request.",
        "operationId": "UpdateProductLimits",
        "parameters": [
          {
            "name": "CompanyLocationKey",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "description": "",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateProductLimitsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeOfSuccessFailureResponse"
                }
              }
            }
          },
          "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": []
          }
        ]
      }
    },
    "/v1.0/file/import": {
      "post": {
        "tags": [
          "file"
        ],
        "summary": "Import one or more files into Stella Connect.",
        "description": "Files are imported into Stella Connect to extract parts, which are the portable, singular geometry units for use within the Stella Connect ecosystem.",
        "operationId": "ImportFile",
        "requestBody": {
          "description": "",
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/ImportFilesRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ImportFilesResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "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": []
          }
        ]
      }
    },
    "/v1.0/file/{FileId}/rendering": {
      "post": {
        "tags": [
          "file"
        ],
        "summary": "Preview a file.",
        "description": "Renders a file to an image format of your choosing.",
        "operationId": "RenderFile",
        "parameters": [
          {
            "name": "FileId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "guid"
            }
          },
          {
            "name": "ImageType",
            "in": "query",
            "schema": {
              "type": "string",
              "nullable": true
            }
          },
          {
            "name": "ImageWidth",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "maximum": 3840,
              "minimum": 1,
              "nullable": true
            }
          },
          {
            "name": "ImageHeight",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "maximum": 2160,
              "minimum": 1,
              "nullable": true
            }
          }
        ],
        "responses": {
          "200": {
            "description": "A preview image of the files content."
          },
          "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": []
          }
        ]
      }
    },
    "/v1.0/invoice/invoices": {
      "post": {
        "tags": [
          "invoice"
        ],
        "summary": "Create batch invoices",
        "description": "Create a batch of draft invoices from a CSV file.",
        "operationId": "CreateBatchInvoices",
        "requestBody": {
          "description": "",
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/CreateBatchInvoiceRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "description": "Accepted"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails2"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "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": []
          }
        ]
      }
    },
    "/v1.0/invoice/send-draft": {
      "post": {
        "tags": [
          "invoice"
        ],
        "summary": "Send a draft invoice",
        "description": "Create a draft invoice. Draft invoices are not automatically sent to the recipient, a user needs to subsequently\nopen the Stella Invoice app, review the draft, and explicitly send it.",
        "operationId": "SendDraftInvoice",
        "requestBody": {
          "description": "",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SendDraftInvoiceRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeOfSendDraftInvoiceResponse"
                }
              }
            }
          },
          "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": []
          }
        ]
      }
    },
    "/v1.0/nesting/linear/multipart": {
      "post": {
        "tags": [
          "nesting"
        ],
        "summary": "Create a multi-part linear nest",
        "description": "Nests multiple distinct parts onto shared linear stock. Returns a\ncombined cut-list with yield metrics. To nest a single part type, use LinearNestSinglePart.",
        "operationId": "LinearNestMultipleParts",
        "requestBody": {
          "description": "",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LinearNestMultiplePartsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeOfLinearNestMultiplePartsResponse"
                }
              }
            }
          },
          "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": []
          }
        ]
      }
    },
    "/v1.0/nesting/linear/singlepart": {
      "post": {
        "tags": [
          "nesting"
        ],
        "summary": "Create a single-part linear nest",
        "description": "Nests a single part onto linear stock. Returns per-bar cut-list and yield results.\nTo nest multiple distinct part types in one call, use LinearNestMultipleParts.",
        "operationId": "LinearNestSinglePart",
        "requestBody": {
          "description": "",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LinearNestSinglePartRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeOfLinearNestSinglePartResponse"
                }
              }
            }
          },
          "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": []
          }
        ]
      }
    },
    "/v1.0/nesting/linear/{NestId}/rendering": {
      "post": {
        "tags": [
          "nesting"
        ],
        "summary": "Render a linear nest to images",
        "description": "This endpoint renders a previously created linear nest to one or more images. \n        \nYou can specify the dimensions of the image, as well as the colors and styles used to represent different elements of the nest (e.g., parts, remnants, dead zones, crop areas).\n        \nNote: Rendering a nest does not modify the nest itself; it simply generates visual representations based on the current state of the nest.",
        "operationId": "RenderLinearNest",
        "parameters": [
          {
            "name": "NestId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "guid"
            }
          }
        ],
        "requestBody": {
          "description": "",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RenderRequest2"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "image/svg",
            "content": {
              "application/json": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "description": "Validation failed or the request was malformed.",
            "content": {
              "application/json": {
                "schema": {
                  "nullable": true,
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not Found"
          },
          "500": {
            "description": "Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          }
        },
        "security": [
          {
            "apikey": []
          }
        ]
      }
    },
    "/v1.0/nesting/planar/multipart": {
      "post": {
        "tags": [
          "nesting"
        ],
        "summary": "Create a multi-part nest",
        "description": "This endpoint creates a planar nest for multiple parts on a specified sheet. Need to turn a file into parts? Check out [Import Part](./import-part)\n\nNote: If you need to nest a single part, please use the single-part nesting endpoint.",
        "operationId": "PlanarNestMultipleParts",
        "requestBody": {
          "description": "",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PlanarNestMultiplePartsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PlanarNestMultiplePartsResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "500": {
            "description": "Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          }
        },
        "security": [
          {
            "apikey": []
          }
        ]
      }
    },
    "/v1.0/nesting/planar/singlepart": {
      "post": {
        "tags": [
          "nesting"
        ],
        "summary": "Create a single-part nest",
        "description": "This endpoint creates a planar nest for a single part on a specified sheet. Need to turn a file into parts? Check out [Import Parts](./import-part)\n\nNote: If you need to nest multiple parts, please use the multi-part nesting endpoint.",
        "operationId": "PlanarNestSinglePart",
        "requestBody": {
          "description": "",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PlanarNestSinglePartRequest"
              },
              "examples": {
                "Simple Example": {
                  "summary": "No Remnants.",
                  "description": "Here is a description.",
                  "value": {
                    "part": {
                      "partId": "3c49ad28-913a-4e92-83a6-5265d9a45759",
                      "partName": "Previously Defined Sample Part",
                      "measurementUnit": null,
                      "grain": false,
                      "quantity": 200
                    },
                    "outputLengthUnit": "in",
                    "outputWeightUnit": "lb",
                    "options": {
                      "clearance": {
                        "edge": 0.25,
                        "edgeUnit": "in",
                        "part": 0.25,
                        "partUnit": "in"
                      },
                      "cropping": {
                        "horizontal": 0,
                        "horizontalUnit": "in",
                        "vertical": 0,
                        "verticalUnit": "in"
                      },
                      "deadZone": {
                        "bottom": 0,
                        "bottomUnit": "in",
                        "left": 0,
                        "leftUnit": "in"
                      },
                      "remnant": {
                        "keepRemnant": true,
                        "minimumLength": 36,
                        "lengthUnit": "in",
                        "minimumWidth": 36,
                        "widthUnit": "in"
                      }
                    },
                    "sheet": {
                      "name": "Carbon-Plate-A36-0.375",
                      "productId": "01HA3CQ2RJ7EVTWFEEDY51ABD1",
                      "variantId": null,
                      "materialType": "Carbon",
                      "density": 0.284,
                      "densityUnit": "lb/in³",
                      "thickness": 0.375,
                      "thicknessUnit": "in",
                      "length": 96,
                      "lengthUnit": "in",
                      "width": 48,
                      "widthUnit": "in",
                      "quantity": 32767
                    }
                  }
                },
                "Simple Example 2": {
                  "summary": "Remnants kept on plates that are 72 x 144.",
                  "description": "The remnant in this example will be kept if there is at least 36\" left either horizontally or vertically.",
                  "value": {
                    "part": {
                      "partId": "6061f3ed-9c9b-4481-9a38-bb39f5279eb9",
                      "partName": "Previously Defined Sample Part",
                      "measurementUnit": null,
                      "grain": false,
                      "quantity": 200
                    },
                    "outputLengthUnit": "in",
                    "outputWeightUnit": "lb",
                    "options": {
                      "clearance": {
                        "edge": 0.25,
                        "edgeUnit": "in",
                        "part": 0.25,
                        "partUnit": "in"
                      },
                      "cropping": {
                        "horizontal": 0,
                        "horizontalUnit": "in",
                        "vertical": 0,
                        "verticalUnit": "in"
                      },
                      "deadZone": {
                        "bottom": 0,
                        "bottomUnit": "in",
                        "left": 0,
                        "leftUnit": "in"
                      },
                      "remnant": {
                        "keepRemnant": false,
                        "minimumLength": null,
                        "lengthUnit": null,
                        "minimumWidth": null,
                        "widthUnit": null
                      }
                    },
                    "sheet": {
                      "name": "Carbon-Plate-A36-0.375",
                      "productId": "01HA3CQ2RJ7EVTWFEEDY51ABD1",
                      "variantId": null,
                      "materialType": "Carbon",
                      "density": 0.284,
                      "densityUnit": "lb/in³",
                      "thickness": 0.375,
                      "thicknessUnit": "in",
                      "length": 96,
                      "lengthUnit": "in",
                      "width": 48,
                      "widthUnit": "in",
                      "quantity": 32767
                    }
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PlanarNestSinglePartResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "500": {
            "description": "Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          }
        },
        "security": [
          {
            "apikey": []
          }
        ]
      }
    },
    "/v1.0/nesting/planar/{NestId}/sheets/{SheetId}/rendering": {
      "post": {
        "tags": [
          "nesting"
        ],
        "summary": "Render a planar nest to images",
        "description": "This endpoint renders a previously created planar nest to one or more images. \n        \nYou can specify the dimensions of the image, as well as the colors and styles used to represent different elements of the nest (e.g., parts, remnants, dead zones, crop areas).\n        \nNote: Rendering a nest does not modify the nest itself; it simply generates visual representations based on the current state of the nest.",
        "operationId": "RenderPlanarNest",
        "parameters": [
          {
            "name": "NestId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "guid"
            }
          },
          {
            "name": "SheetId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "guid"
            }
          }
        ],
        "requestBody": {
          "description": "",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RenderRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/NestingResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "500": {
            "description": "Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          }
        },
        "security": [
          {
            "apikey": []
          }
        ]
      }
    },
    "/v1.0/parts/import": {
      "post": {
        "tags": [
          "parts"
        ],
        "summary": "Import one or more part files",
        "description": "Parts are the portable, singular geometry units for use within the Stella Connect ecosystem.\n\nYou'll need these if you want to perform a Nest, for example. If you use a file that has multiple parts (separate closed contours) we will attempt to extract all of the individual parts contained within that file.\n\nFile types supported:\n    - DXF\n    - DWG\n    - STEP\n    - IGES\n    - SLDPRT\n    - SLDASM\n    - SLDDRW\n    - ZIP",
        "operationId": "ImportPart",
        "requestBody": {
          "description": "",
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/ImportPartsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ImportPartsResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "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": []
          }
        ]
      }
    },
    "/v1.0/parts/{PartId}/rendering": {
      "post": {
        "tags": [
          "parts"
        ],
        "summary": "Render a part",
        "description": "Renders a part to an image format of your choosing.",
        "operationId": "RenderPart",
        "parameters": [
          {
            "name": "PartId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "guid"
            }
          }
        ],
        "requestBody": {
          "description": "",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RenderPartRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RenderPartResponse"
                }
              }
            }
          },
          "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": []
          }
        ]
      }
    },
    "/v1.0/usage/summary": {
      "get": {
        "tags": [
          "usage"
        ],
        "summary": "Return API usage summary",
        "description": "Returns a summary of API usage metrics.",
        "operationId": "GetUsageSummary",
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConnectEnvelopeOfGetUsageResponse"
                }
              }
            }
          },
          "400": {
            "description": "Validation failed or the request was malformed.",
            "content": {
              "application/json": {
                "schema": {
                  "nullable": true,
                  "$ref": "#/components/schemas/ConnectEnvelopeObjectResult"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "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"
          }
        }
      },
      "ConnectEnvelopeOfGetUsageResponse": {
        "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/GetUsageResponse"
          },
          "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"
          }
        }
      },
      "GetUsageResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "requestsLast24H": {
            "type": "integer",
            "description": "Total number of API requests made in the last 24 hours",
            "format": "int32"
          }
        }
      },
      "RenderPartResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "partId",
          "imageData"
        ],
        "properties": {
          "partId": {
            "type": "string",
            "description": "Unique identifier for the rendered part",
            "format": "guid"
          },
          "imageData": {
            "type": "string",
            "description": "Base64-encoded PNG image of the part rendering"
          }
        }
      },
      "RenderPartRequest": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "imageType": {
            "type": "string",
            "pattern": "^(png|svg|pdf)$"
          },
          "imageWidth": {
            "type": "integer",
            "format": "int32",
            "maximum": 2147483647,
            "minimum": 0,
            "nullable": true,
            "exclusiveMinimum": true
          },
          "imageHeight": {
            "type": "integer",
            "format": "int32",
            "maximum": 2147483647,
            "minimum": 0,
            "nullable": true,
            "exclusiveMinimum": true
          }
        }
      },
      "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"
              }
            }
          }
        }
      },
      "ImportPartsResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "files": {
            "type": "array",
            "description": "Collection of imported file results",
            "items": {
              "$ref": "#/components/schemas/File"
            }
          }
        }
      },
      "File": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "measurementSystem": {
            "type": "string",
            "description": "Measurement system used (e.g., \"metric\", \"imperial\")"
          },
          "measurementUnit": {
            "type": "string",
            "description": "Unit of measurement for dimensions (e.g., \"mm\", \"in\")"
          },
          "name": {
            "type": "string",
            "description": "Original filename of the imported file"
          },
          "parts": {
            "type": "array",
            "description": "Collection of parts extracted from this file",
            "items": {
              "$ref": "#/components/schemas/Part"
            }
          },
          "image": {
            "type": "string",
            "description": "Deprecated. Please use /parts/{partId}/rendering endpoint to get part images."
          }
        }
      },
      "Part": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier for the part",
            "format": "guid"
          },
          "area": {
            "type": "number",
            "description": "True surface area of the part in the file's measurement units",
            "format": "double"
          },
          "contours": {
            "type": "integer",
            "description": "Number of contour profiles in the part geometry",
            "format": "int32"
          },
          "depth": {
            "type": "number",
            "description": "Depth dimension of the part",
            "format": "double"
          },
          "length": {
            "type": "number",
            "description": "Length dimension of the part",
            "format": "double"
          },
          "measurementSystem": {
            "type": "string",
            "description": "Measurement system used for this part's dimensions"
          },
          "measurementUnit": {
            "type": "string",
            "description": "Unit of measurement for this part's dimensions"
          },
          "name": {
            "type": "string",
            "description": "Name of the part within the file"
          },
          "outsideArea": {
            "type": "number",
            "description": "Outside boundary area of the part",
            "format": "double"
          },
          "perimeter": {
            "type": "number",
            "description": "Total perimeter length of the part profile",
            "format": "double"
          },
          "rectangularArea": {
            "type": "number",
            "description": "Bounding-box area of the part (length × width)",
            "format": "double"
          },
          "width": {
            "type": "number",
            "description": "Width dimension of the part",
            "format": "double"
          },
          "image": {
            "type": "string",
            "description": "Deprecated. Please use /parts/{partId}/rendering endpoint to get part images."
          }
        }
      },
      "ImportPartsRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "files"
        ],
        "properties": {
          "files": {
            "type": "array",
            "minLength": 1,
            "nullable": false,
            "items": {
              "type": "string",
              "format": "binary"
            }
          }
        }
      },
      "PlanarNestMultiplePartsResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "nestingId": {
            "type": "string",
            "description": "The unique identifier for the nesting operation.",
            "format": "guid"
          },
          "sheet": {
            "description": "The collection of Sheet information used in the nesting operation.",
            "$ref": "#/components/schemas/SheetResponse"
          },
          "parts": {
            "type": "array",
            "description": "The collection of part responses included in the nesting operation.",
            "items": {
              "$ref": "#/components/schemas/PartResponse"
            }
          }
        }
      },
      "SheetResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "sheetId": {
            "type": "string",
            "description": "Unique identifier for the sheet/plate",
            "format": "guid"
          },
          "name": {
            "type": "string",
            "description": "Display name of the sheet material"
          },
          "productId": {
            "type": "string",
            "description": "Product identifier for the sheet in the material catalog"
          },
          "density": {
            "type": "number",
            "description": "Material density",
            "format": "double"
          },
          "densityUnit": {
            "type": "string",
            "description": "Unit of measure for density"
          },
          "thickness": {
            "type": "number",
            "description": "Sheet thickness",
            "format": "double"
          },
          "thicknessUnit": {
            "type": "string",
            "description": "Unit of measure for thickness"
          },
          "materialType": {
            "type": "string",
            "description": "Material classification (e.g., \"Steel\", \"Aluminum\")"
          },
          "length": {
            "type": "number",
            "description": "Sheet length",
            "format": "double"
          },
          "lengthUnit": {
            "type": "string",
            "description": "Unit of measure for length"
          },
          "width": {
            "type": "number",
            "description": "Sheet width",
            "format": "double"
          },
          "widthUnit": {
            "type": "string",
            "description": "Unit of measure for width"
          },
          "weightUnit": {
            "type": "string",
            "description": "Unit of measure for weight values"
          },
          "totalWeight": {
            "type": "number",
            "description": "Total weight of all plates.",
            "format": "double"
          },
          "totalWeightUsed": {
            "type": "number",
            "description": "Total used weight of all plates.",
            "format": "double"
          },
          "numberOfSheetsRequired": {
            "type": "integer",
            "description": "Total number of sheets required to nest parts.",
            "format": "int32"
          },
          "numberOfSheetsPercentage": {
            "type": "number",
            "description": "Average utilization percentage across all sheets",
            "format": "double"
          },
          "sheetUsage": {
            "type": "array",
            "description": "Breakdown of how sheets are used across the nesting groups",
            "items": {
              "$ref": "#/components/schemas/SheetUsageResponse"
            }
          }
        }
      },
      "SheetUsageResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "keepRemnant": {
            "type": "boolean",
            "description": "Whether remnant material is retained after this nesting group"
          },
          "remnantCropType": {
            "type": "string",
            "description": "How the remnant is cropped (e.g., \"full-width\", \"partial\")"
          },
          "weightUsed": {
            "type": "number",
            "description": "Total material weight consumed in this nesting group",
            "format": "double"
          },
          "numberOfSheets": {
            "type": "integer",
            "description": "Number of sheets in this nesting group",
            "format": "int32"
          },
          "partsUsed": {
            "type": "array",
            "description": "Parts nested on the sheets in this nesting group",
            "items": {
              "$ref": "#/components/schemas/PartsNestedResponse"
            }
          }
        }
      },
      "PartsNestedResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "partId": {
            "type": "string",
            "description": "Unique identifier for the part",
            "format": "guid"
          },
          "numberOfPartsNested": {
            "type": "integer",
            "description": "Total number of parts nested on all sheets in group.",
            "format": "int32"
          },
          "unitNestedWeight": {
            "type": "number",
            "description": "Weight of one nested piece of this part",
            "format": "double"
          }
        }
      },
      "PartResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "partId": {
            "type": "string",
            "description": "The unique identifier for the part.",
            "format": "guid"
          },
          "name": {
            "type": "string",
            "description": "The given name of the part."
          },
          "unitRectangularWeight": {
            "type": "number",
            "description": "The unit rectangular weight of the part.",
            "format": "double"
          },
          "unitTrueWeight": {
            "type": "number",
            "description": "The true weight of the part.",
            "format": "double"
          }
        }
      },
      "PlanarNestMultiplePartsRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "options",
          "sheet",
          "parts"
        ],
        "properties": {
          "outputLengthUnit": {
            "type": "string",
            "description": "The unit of measurement for output lengths."
          },
          "outputWeightUnit": {
            "type": "string",
            "description": "The unit of measurement for output weights."
          },
          "options": {
            "$ref": "#/components/schemas/NestingOptions"
          },
          "sheet": {
            "nullable": false,
            "$ref": "#/components/schemas/NestingSheet"
          },
          "parts": {
            "type": "array",
            "minLength": 1,
            "nullable": false,
            "items": {
              "$ref": "#/components/schemas/NestingPart"
            }
          }
        }
      },
      "NestingOptions": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "clearance": {
            "$ref": "#/components/schemas/ClearanceOptions"
          },
          "cropping": {
            "$ref": "#/components/schemas/CroppingOptions"
          },
          "deadZone": {
            "$ref": "#/components/schemas/DeadzoneOptions"
          },
          "remnant": {
            "$ref": "#/components/schemas/RemnantPolicy"
          }
        }
      },
      "ClearanceOptions": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "edge": {
            "type": "number",
            "format": "float"
          },
          "edgeUnit": {
            "type": "string"
          },
          "part": {
            "type": "number",
            "format": "float"
          },
          "partUnit": {
            "type": "string"
          }
        }
      },
      "CroppingOptions": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "horizontal": {
            "type": "number",
            "format": "float"
          },
          "horizontalUnit": {
            "type": "string"
          },
          "vertical": {
            "type": "number",
            "format": "float"
          },
          "verticalUnit": {
            "type": "string"
          }
        }
      },
      "DeadzoneOptions": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "bottom": {
            "type": "number",
            "format": "float"
          },
          "bottomUnit": {
            "type": "string"
          },
          "left": {
            "type": "number",
            "format": "float"
          },
          "leftUnit": {
            "type": "string"
          }
        }
      },
      "RemnantPolicy": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "keepRemnant": {
            "type": "boolean"
          },
          "minimumLength": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "lengthUnit": {
            "type": "string",
            "nullable": true
          },
          "minimumWidth": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "widthUnit": {
            "type": "string",
            "nullable": true
          }
        }
      },
      "NestingSheet": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "name": {
            "type": "string"
          },
          "productId": {
            "type": "string"
          },
          "variantId": {
            "type": "string",
            "nullable": true
          },
          "materialType": {
            "type": "string"
          },
          "density": {
            "type": "number",
            "format": "double"
          },
          "densityUnit": {
            "type": "string"
          },
          "thickness": {
            "type": "number",
            "format": "double"
          },
          "thicknessUnit": {
            "type": "string"
          },
          "length": {
            "type": "number",
            "format": "double"
          },
          "lengthUnit": {
            "type": "string"
          },
          "width": {
            "type": "number",
            "format": "double"
          },
          "widthUnit": {
            "type": "string"
          },
          "quantity": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "NestingPart": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "partId"
        ],
        "properties": {
          "partId": {
            "type": "string",
            "format": "guid",
            "minLength": 1,
            "nullable": false
          },
          "partName": {
            "type": "string"
          },
          "measurementUnit": {
            "type": "string",
            "description": "Override for the part's measurement unit. Leave null to use the unit stored on the part.",
            "nullable": true
          },
          "grain": {
            "type": "boolean"
          },
          "quantity": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "exclusiveMinimum": true
          }
        }
      },
      "PlanarNestSinglePartResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "nestingId": {
            "type": "string",
            "description": "The unique identifier for the nesting operation.",
            "format": "guid"
          },
          "sheet": {
            "description": "The collection of Sheet information used in the nesting operation.",
            "$ref": "#/components/schemas/SheetResponse"
          },
          "part": {
            "description": "The part response included in the nesting operation.",
            "$ref": "#/components/schemas/PartResponse"
          }
        }
      },
      "PlanarNestSinglePartRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "options",
          "sheet",
          "part"
        ],
        "properties": {
          "outputLengthUnit": {
            "type": "string",
            "description": "The unit of measurement for output lengths.",
            "example": "in"
          },
          "outputWeightUnit": {
            "type": "string",
            "description": "The unit of measurement for output weights.",
            "example": "lb"
          },
          "options": {
            "example": {
              "clearance": {
                "edge": 0.25,
                "edgeUnit": "in",
                "part": 0.25,
                "partUnit": "in"
              },
              "cropping": {
                "horizontal": 0,
                "horizontalUnit": "in",
                "vertical": 0,
                "verticalUnit": "in"
              },
              "deadZone": {
                "bottom": 0,
                "bottomUnit": "in",
                "left": 0,
                "leftUnit": "in"
              },
              "remnant": {
                "keepRemnant": true,
                "minimumLength": 36,
                "lengthUnit": "in",
                "minimumWidth": 36,
                "widthUnit": "in"
              }
            },
            "$ref": "#/components/schemas/NestingOptions"
          },
          "sheet": {
            "nullable": false,
            "example": {
              "name": "Carbon-Plate-A36-0.375",
              "productId": "01HA3CQ2RJ7EVTWFEEDY51ABD1",
              "variantId": null,
              "materialType": "Carbon",
              "density": 0.284,
              "densityUnit": "lb/in³",
              "thickness": 0.375,
              "thicknessUnit": "in",
              "length": 96,
              "lengthUnit": "in",
              "width": 48,
              "widthUnit": "in",
              "quantity": 32767
            },
            "$ref": "#/components/schemas/NestingSheet"
          },
          "part": {
            "nullable": false,
            "example": {
              "partId": "3c49ad28-913a-4e92-83a6-5265d9a45759",
              "partName": "Previously Defined Sample Part",
              "measurementUnit": null,
              "grain": false,
              "quantity": 200
            },
            "$ref": "#/components/schemas/NestingPart"
          }
        }
      },
      "NestingResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "nestingId": {
            "type": "string",
            "description": "The unique identifier for the nesting operation.",
            "format": "guid"
          },
          "sheet": {
            "description": "The collection of Sheet information used in the nesting operation.",
            "$ref": "#/components/schemas/SheetResponse"
          }
        }
      },
      "RenderRequest": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "shouldKeepRemnant": {
            "type": "boolean"
          },
          "shouldRenderFullSheet": {
            "type": "boolean"
          },
          "backgroundColor": {
            "type": "string"
          },
          "imageHeight": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "exclusiveMinimum": true
          },
          "imageWidth": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "exclusiveMinimum": true
          },
          "imageType": {
            "type": "string"
          },
          "crop": {
            "$ref": "#/components/schemas/RenderingOptions"
          },
          "deadZone": {
            "$ref": "#/components/schemas/RenderingOptions"
          },
          "part": {
            "$ref": "#/components/schemas/RenderingOptions"
          },
          "remnant": {
            "$ref": "#/components/schemas/RenderingOptions"
          }
        }
      },
      "RenderingOptions": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "fillColor": {
            "type": "string"
          },
          "hatchStyle": {
            "nullable": true,
            "$ref": "#/components/schemas/HatchStyle"
          },
          "strokeColor": {
            "type": "string"
          },
          "strokeStyle": {
            "$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"
        ]
      },
      "ConnectEnvelopeOfLinearNestMultiplePartsResponse": {
        "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/LinearNestMultiplePartsResponse"
          },
          "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"
          }
        }
      },
      "LinearNestMultiplePartsResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "nestingId": {
            "type": "string",
            "description": "Unique identifier for the nesting result",
            "format": "guid"
          },
          "parts": {
            "type": "array",
            "description": "Collection of nesting results for each part",
            "items": {
              "$ref": "#/components/schemas/NestedPartResponse"
            }
          },
          "stock": {
            "type": "array",
            "description": "Collection of stock layouts used across all parts",
            "items": {
              "$ref": "#/components/schemas/MultiPartStockLayoutResponse"
            }
          }
        }
      },
      "NestedPartResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "partId": {
            "type": "string",
            "description": "Unique identifier for the part",
            "format": "guid"
          },
          "quantity": {
            "type": "integer",
            "description": "Requested quantity for this part",
            "format": "int32"
          },
          "length": {
            "type": "number",
            "description": "Required cut length per piece",
            "format": "double"
          },
          "lengthUnit": {
            "type": "string",
            "description": "Unit of measure for the length (e.g., \"Inch\", \"Millimeter\")"
          },
          "totalItemsNested": {
            "type": "integer",
            "description": "Total number of pieces successfully nested",
            "format": "int32"
          },
          "totalNestedLength": {
            "type": "number",
            "description": "Total cut length for all nested pieces",
            "format": "double"
          },
          "totalNestedWeight": {
            "type": "number",
            "description": "Total weight of the nested material used",
            "format": "double"
          },
          "totalTrueWeight": {
            "type": "number",
            "description": "Total true (actual part geometry) weight of all nested pieces",
            "format": "double"
          }
        }
      },
      "MultiPartStockLayoutResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "stockId": {
            "type": "string",
            "description": "Unique identifier for the stock item",
            "format": "guid"
          },
          "numberOfPartsPerUnit": {
            "type": "integer",
            "description": "Number of parts cut from a single stock unit",
            "format": "int32"
          },
          "keepRemnant": {
            "type": "boolean",
            "description": "Whether remnants are retained after cutting"
          },
          "numberOfUnits": {
            "type": "integer",
            "description": "Total number of stock units required",
            "format": "int32"
          },
          "totalStockLength": {
            "type": "number",
            "description": "Total length of all stock units combined",
            "format": "double"
          },
          "totalStockLengthUsed": {
            "type": "number",
            "description": "Total length consumed across all stock units",
            "format": "double"
          },
          "totalStockWeight": {
            "type": "number",
            "description": "Total weight of all stock units combined",
            "format": "double"
          },
          "totalStockWeightUsed": {
            "type": "number",
            "description": "Total weight of material consumed across all stock units",
            "format": "double"
          },
          "unitStockLength": {
            "type": "number",
            "description": "Length of a single stock unit",
            "format": "double"
          },
          "unitStockLengthUsed": {
            "type": "number",
            "description": "Length consumed from a single stock unit",
            "format": "double"
          },
          "unitStockWeight": {
            "type": "number",
            "description": "Weight of a single stock unit",
            "format": "double"
          },
          "unitStockWeightUsed": {
            "type": "number",
            "description": "Weight of material consumed from a single stock unit",
            "format": "double"
          },
          "lengthUnit": {
            "type": "string",
            "description": "Unit of measure for all length values"
          },
          "weightUnit": {
            "type": "string",
            "description": "Unit of measure for all weight values"
          },
          "parts": {
            "type": "array",
            "description": "The parts nested on this stock layout",
            "items": {
              "$ref": "#/components/schemas/StockPartResponse"
            }
          }
        }
      },
      "StockPartResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "partId": {
            "type": "string",
            "description": "Unique identifier for the part",
            "format": "guid"
          },
          "quantity": {
            "type": "integer",
            "description": "Number of pieces of this part cut from the stock unit",
            "format": "int32"
          }
        }
      },
      "LinearNestMultiplePartsRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "stock",
          "parts"
        ],
        "properties": {
          "outputLengthUnit": {
            "type": "string"
          },
          "outputWeightUnit": {
            "type": "string"
          },
          "stock": {
            "nullable": false,
            "$ref": "#/components/schemas/StockItem"
          },
          "options": {
            "nullable": true,
            "$ref": "#/components/schemas/NestingOptions2"
          },
          "parts": {
            "type": "array",
            "minLength": 1,
            "nullable": false,
            "items": {
              "$ref": "#/components/schemas/PartItem"
            }
          }
        }
      },
      "StockItem": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "weightPerLength",
          "length"
        ],
        "properties": {
          "name": {
            "type": "string"
          },
          "weightPerLength": {
            "type": "number",
            "format": "double"
          },
          "weightPerLengthUnit": {
            "type": "string"
          },
          "length": {
            "type": "number",
            "format": "double"
          },
          "lengthUnit": {
            "type": "string"
          },
          "quantity": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          }
        }
      },
      "NestingOptions2": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "chuck": {
            "type": "number",
            "format": "double"
          },
          "chuckUnit": {
            "type": "string"
          },
          "kerf": {
            "type": "number",
            "format": "double"
          },
          "kerfUnit": {
            "type": "string"
          },
          "remnantPolicy": {
            "$ref": "#/components/schemas/LinearRemnantPolicy"
          }
        }
      },
      "LinearRemnantPolicy": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "keepRemnant": {
            "type": "boolean"
          },
          "minimumLength": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "lengthUnit": {
            "type": "string"
          }
        }
      },
      "PartItem": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "length",
          "lengthUnit",
          "quantity"
        ],
        "properties": {
          "length": {
            "type": "number",
            "format": "double",
            "minimum": 0,
            "exclusiveMinimum": true
          },
          "lengthUnit": {
            "type": "string",
            "minLength": 1
          },
          "quantity": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "exclusiveMinimum": true
          }
        }
      },
      "ConnectEnvelopeOfLinearNestSinglePartResponse": {
        "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/LinearNestSinglePartResponse"
          },
          "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"
          }
        }
      },
      "LinearNestSinglePartResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "nestingId": {
            "type": "string",
            "description": "Unique identifier for the nesting result",
            "format": "guid"
          },
          "part": {
            "description": "Nesting result for the single part",
            "$ref": "#/components/schemas/NestedPartResponse"
          },
          "stock": {
            "type": "array",
            "description": "Collection of stock layouts used to fulfill the part quantity",
            "items": {
              "$ref": "#/components/schemas/SinglePartStockLayoutResponse"
            }
          }
        }
      },
      "SinglePartStockLayoutResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "stockId": {
            "type": "string",
            "description": "Unique identifier for the stock item",
            "format": "guid"
          },
          "numberOfPartsPerUnit": {
            "type": "integer",
            "description": "Number of parts cut from a single stock unit",
            "format": "int32"
          },
          "keepRemnant": {
            "type": "boolean",
            "description": "Whether remnants are retained after cutting"
          },
          "numberOfUnits": {
            "type": "integer",
            "description": "Total number of stock units required",
            "format": "int32"
          },
          "totalStockLength": {
            "type": "number",
            "description": "Total length of all stock units combined",
            "format": "double"
          },
          "totalStockLengthUsed": {
            "type": "number",
            "description": "Total length consumed across all stock units",
            "format": "double"
          },
          "totalStockWeight": {
            "type": "number",
            "description": "Total weight of all stock units combined",
            "format": "double"
          },
          "totalStockWeightUsed": {
            "type": "number",
            "description": "Total weight of material consumed across all stock units",
            "format": "double"
          },
          "unitStockLength": {
            "type": "number",
            "description": "Length of a single stock unit",
            "format": "double"
          },
          "unitStockLengthUsed": {
            "type": "number",
            "description": "Length consumed from a single stock unit",
            "format": "double"
          },
          "unitStockWeight": {
            "type": "number",
            "description": "Weight of a single stock unit",
            "format": "double"
          },
          "unitStockWeightUsed": {
            "type": "number",
            "description": "Weight of material consumed from a single stock unit",
            "format": "double"
          },
          "lengthUnit": {
            "type": "string",
            "description": "Unit of measure for all length values"
          },
          "weightUnit": {
            "type": "string",
            "description": "Unit of measure for all weight values"
          },
          "part": {
            "description": "The part nested on this stock layout",
            "$ref": "#/components/schemas/StockPartResponse"
          }
        }
      },
      "LinearNestSinglePartRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "stock",
          "part"
        ],
        "properties": {
          "outputLengthUnit": {
            "type": "string"
          },
          "outputWeightUnit": {
            "type": "string"
          },
          "stock": {
            "nullable": false,
            "$ref": "#/components/schemas/StockItem"
          },
          "options": {
            "nullable": true,
            "$ref": "#/components/schemas/NestingOptions2"
          },
          "part": {
            "nullable": false,
            "$ref": "#/components/schemas/PartItem"
          }
        }
      },
      "RenderRequest2": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "imageHeight": {
            "type": "integer",
            "format": "int32",
            "maximum": 2147483647,
            "minimum": 1,
            "nullable": true
          },
          "imageWidth": {
            "type": "integer",
            "format": "int32",
            "maximum": 2147483647,
            "minimum": 1,
            "nullable": true
          },
          "chuck": {
            "$ref": "#/components/schemas/RenderingOptions"
          },
          "kerf": {
            "$ref": "#/components/schemas/RenderingOptions"
          },
          "part": {
            "$ref": "#/components/schemas/RenderingOptions"
          },
          "remnant": {
            "$ref": "#/components/schemas/RenderingOptions"
          }
        }
      },
      "ProblemDetails": {
        "type": "object",
        "description": "RFC9457 compatible problem details/ error response class. this can be used by configuring startup like so:\napp.UseFastEndpoints(c => c.Errors.UseProblemDetails())",
        "additionalProperties": false,
        "properties": {
          "type": {
            "type": "string",
            "default": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.1"
          },
          "title": {
            "type": "string",
            "default": "One or more validation errors occurred."
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "default": 400
          },
          "instance": {
            "type": "string",
            "default": "/api/route"
          },
          "traceId": {
            "type": "string",
            "default": "0HMPNHL0JHL76:00000001"
          },
          "detail": {
            "type": "string",
            "description": "the details of the error",
            "nullable": true
          },
          "errors": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ProblemDetails_Error"
            }
          }
        }
      },
      "ProblemDetails_Error": {
        "type": "object",
        "description": "the error details object",
        "additionalProperties": false,
        "properties": {
          "name": {
            "type": "string",
            "description": "the name of the error or property of the dto that caused the error",
            "default": "Error or field name"
          },
          "reason": {
            "type": "string",
            "description": "the reason for the error",
            "default": "Error reason"
          },
          "code": {
            "type": "string",
            "description": "the code of the error",
            "nullable": true
          },
          "severity": {
            "type": "string",
            "description": "the severity of the error",
            "nullable": true
          }
        }
      },
      "ProblemDetails2": {
        "type": "object",
        "additionalProperties": {
          "nullable": true
        },
        "properties": {
          "type": {
            "type": "string",
            "nullable": true
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "detail": {
            "type": "string",
            "nullable": true
          },
          "instance": {
            "type": "string",
            "nullable": true
          }
        }
      },
      "CreateBatchInvoiceRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "file"
        ],
        "properties": {
          "file": {
            "type": "string",
            "format": "binary",
            "nullable": false
          }
        }
      },
      "ConnectEnvelopeOfSendDraftInvoiceResponse": {
        "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/SendDraftInvoiceResponse"
          },
          "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"
          }
        }
      },
      "SendDraftInvoiceResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "invoiceId": {
            "type": "string",
            "description": "Unique identifier for the invoice that was sent"
          },
          "status": {
            "type": "string",
            "description": "Status of the invoice after sending (e.g., \"sent\")"
          }
        }
      },
      "SendDraftInvoiceRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "to",
          "subtotal",
          "taxAmount",
          "total",
          "lineItems"
        ],
        "properties": {
          "to": {
            "minLength": 1,
            "nullable": false,
            "$ref": "#/components/schemas/InvoiceTo"
          },
          "dueDate": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "subtotal": {
            "type": "number",
            "format": "decimal",
            "minimum": 0,
            "minLength": 1,
            "nullable": false,
            "exclusiveMinimum": true
          },
          "taxAmount": {
            "type": "number",
            "format": "decimal",
            "minimum": 0
          },
          "shippingFee": {
            "type": "number",
            "format": "decimal",
            "nullable": true
          },
          "total": {
            "type": "number",
            "format": "decimal",
            "minLength": 1,
            "nullable": false
          },
          "lineItems": {
            "type": "array",
            "minLength": 1,
            "nullable": false,
            "items": {
              "$ref": "#/components/schemas/LineItem"
            }
          },
          "notes": {
            "type": "string",
            "nullable": true
          },
          "paymentTerms": {
            "type": "string",
            "nullable": true
          },
          "externalId": {
            "type": "string",
            "nullable": true
          },
          "externalIdLink": {
            "type": "string",
            "nullable": true
          }
        }
      },
      "InvoiceTo": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "emailAddress",
          "businessName"
        ],
        "properties": {
          "emailAddress": {
            "type": "string",
            "minLength": 1
          },
          "businessName": {
            "type": "string",
            "minLength": 1
          }
        }
      },
      "LineItem": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "description",
          "quantity",
          "unitPrice",
          "itemTotal"
        ],
        "properties": {
          "description": {
            "type": "string",
            "minLength": 1
          },
          "quantity": {
            "type": "integer",
            "format": "int32"
          },
          "unitPrice": {
            "type": "number",
            "format": "decimal"
          },
          "itemTotal": {
            "type": "number",
            "format": "decimal"
          }
        }
      },
      "ImportFilesResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "files": {
            "type": "array",
            "description": "Collection of imported file results",
            "items": {
              "$ref": "#/components/schemas/File2"
            }
          }
        }
      },
      "File2": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier for the imported file"
          },
          "name": {
            "type": "string",
            "description": "Original filename of the imported file"
          },
          "previewUrl": {
            "type": "string",
            "description": "URL to a preview image of the file, if available"
          }
        }
      },
      "ImportFilesRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "files"
        ],
        "properties": {
          "files": {
            "type": "array",
            "minLength": 1,
            "nullable": false,
            "items": {
              "type": "string",
              "format": "binary"
            }
          }
        }
      },
      "ConnectEnvelopeOfListCompanyLocationsResponse": {
        "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/ListCompanyLocationsResponse"
          },
          "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"
          }
        }
      },
      "ListCompanyLocationsResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "locations": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CompanyLocation"
            }
          }
        }
      },
      "CompanyLocation": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "key": {
            "type": "string",
            "description": "Unique identifier for the company location",
            "format": "guid"
          },
          "name": {
            "type": "string",
            "description": "Display name of the location"
          },
          "alias": {
            "type": "string",
            "description": "Short alias or code for the location"
          },
          "isPrimary": {
            "type": "boolean",
            "description": "Whether this is the primary location for the company"
          },
          "phoneNumber": {
            "type": "string",
            "description": "Phone number for this location"
          },
          "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"
          }
        }
      },
      "ConnectEnvelopeOfListContactCompaniesResponse": {
        "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/ListContactCompaniesResponse"
          },
          "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"
          }
        }
      },
      "ListContactCompaniesResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ContactCompanyItem"
            }
          }
        }
      },
      "ContactCompanyItem": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "contactCompanyKey": {
            "type": "string",
            "description": "Unique identifier for the contact company",
            "format": "guid"
          },
          "name": {
            "type": "string",
            "description": "Display name of the contact company"
          }
        }
      },
      "ConnectEnvelopeOfListContactLocationsResponse": {
        "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/ListContactLocationsResponse"
          },
          "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"
          }
        }
      },
      "ListContactLocationsResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ContactLocationItem"
            }
          }
        }
      },
      "ContactLocationItem": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "contactCompanyLocationKey": {
            "type": "string",
            "description": "Unique identifier for this contact company location",
            "format": "guid"
          },
          "name": {
            "type": "string",
            "description": "Display name for this location"
          },
          "isTaxExempt": {
            "type": "boolean",
            "description": "Whether this location is exempt from tax calculations"
          },
          "paymentTermKey": {
            "type": "string",
            "description": "Identifier for the payment terms applied to this location",
            "format": "guid"
          },
          "priceTierKey": {
            "type": "string",
            "description": "Identifier for the price tier applied to this location, or null if using default pricing",
            "format": "guid",
            "nullable": true
          },
          "isLinkedToStellaCompany": {
            "type": "boolean",
            "description": "Whether this contact location is linked to a supplier company in Stella"
          },
          "location": {
            "description": "Physical address details for this location",
            "$ref": "#/components/schemas/ContactLocationItemDetail"
          }
        }
      },
      "ContactLocationItemDetail": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "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"
          }
        }
      },
      "ConnectEnvelopeOfListContactsResponse": {
        "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/ListContactsResponse"
          },
          "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"
          }
        }
      },
      "ListContactsResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ContactItem"
            }
          }
        }
      },
      "ContactItem": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "contactKey": {
            "type": "string",
            "description": "Unique identifier for the contact",
            "format": "guid"
          },
          "contactCompanyLocationKey": {
            "type": "string",
            "description": "Identifier for the contact company location this contact belongs to",
            "format": "guid"
          },
          "emailAddress": {
            "type": "string",
            "description": "Email address of the contact"
          },
          "firstName": {
            "type": "string",
            "description": "First name of the contact"
          },
          "lastName": {
            "type": "string",
            "description": "Last name of the contact"
          },
          "phoneNumber": {
            "type": "string",
            "description": "Phone number of the contact"
          },
          "externalId": {
            "type": "string",
            "description": "External ERP identifier for the contact, if set",
            "nullable": true
          }
        }
      },
      "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": {
          "quoteNumber": {
            "type": "string",
            "description": "Quote/Order Number as it appears in Stella"
          },
          "orderId": {
            "type": "string",
            "description": "Unique identifier for the quote/order in Stella"
          },
          "orderNumber": {
            "type": "string",
            "description": "Order Number entered by the supplier when the contract was signed"
          },
          "createdAt": {
            "type": "string",
            "description": "Date the Order was created",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "description": "Date the Order was last Updated",
            "format": "date-time"
          },
          "freight": {
            "type": "string",
            "description": "Freight/shipping method selected for the order"
          },
          "location": {
            "type": "string",
            "description": "Supplier company location name associated with this order"
          },
          "status": {
            "description": "Current status of the order in the quoting/ordering workflow",
            "$ref": "#/components/schemas/QuoteRequestStatus"
          },
          "poNumber": {
            "type": "string",
            "description": "Purchase Order Number as entered by the purchaser"
          },
          "notes": {
            "type": "string",
            "description": "Purchase Order Notes as entered by the purchaser"
          },
          "connectIntegrationId": {
            "type": "string",
            "description": "Integration identifier used to correlate this order with an external system"
          },
          "lines": {
            "type": "array",
            "description": "Collection of line items in the order",
            "items": {
              "$ref": "#/components/schemas/OrderLineItem"
            }
          },
          "salesTaxAmount": {
            "type": "number",
            "description": "Sales tax amount charged for the order",
            "format": "decimal"
          },
          "miscellaneousCosts": {
            "type": "object",
            "description": "Collection of miscellaneous costs associated with the order",
            "additionalProperties": {
              "type": "number",
              "format": "decimal"
            }
          },
          "supplierCompanyName": {
            "type": "string",
            "description": "Name of the supplier company fulfilling the order"
          },
          "supplierAddressLine1": {
            "type": "string",
            "description": "Supplier street address line 1"
          },
          "supplierAddressLine2": {
            "type": "string",
            "description": "Supplier street address line 2"
          },
          "supplierLocality": {
            "type": "string",
            "description": "Supplier city or locality"
          },
          "supplierStateOrProvince": {
            "type": "string",
            "description": "Supplier state or province"
          },
          "supplierPostalCode": {
            "type": "string",
            "description": "Supplier postal or ZIP code"
          },
          "supplierCountry": {
            "type": "string",
            "description": "Supplier country code"
          },
          "purchaserCompanyName": {
            "type": "string",
            "description": "Name of the purchasing company"
          },
          "purchaserAddressLine1": {
            "type": "string",
            "description": "Purchaser street address line 1"
          },
          "purchaserAddressLine2": {
            "type": "string",
            "description": "Purchaser street address line 2"
          },
          "purchaserLocality": {
            "type": "string",
            "description": "Purchaser city or locality"
          },
          "purchaserStateOrProvince": {
            "type": "string",
            "description": "Purchaser state or province"
          },
          "purchaserPostalCode": {
            "type": "string",
            "description": "Purchaser postal or ZIP code"
          },
          "purchaserCountry": {
            "type": "string",
            "description": "Purchaser country code"
          },
          "purchaserEmailAddress": {
            "type": "string",
            "description": "Email address of the purchaser contact"
          },
          "purchaserFirstName": {
            "type": "string",
            "description": "First name of the purchaser contact"
          },
          "purchaserLastName": {
            "type": "string",
            "description": "Last name of the purchaser contact"
          },
          "purchaserLocationExternalId": {
            "type": "string",
            "description": "This is the external Id from the Suppliers ERP that should align to the purchasing location in that system.  Same as the ExternalId from the ContactCompanyLocation in the List Contact Endpoint",
            "nullable": true
          }
        }
      },
      "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"
        ]
      },
      "OrderLineItem": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier for the line item"
          },
          "partNumber": {
            "type": "string",
            "description": "Customer-supplied part number for this line item"
          },
          "quantity": {
            "type": "integer",
            "description": "Quantity ordered",
            "format": "int32"
          },
          "process": {
            "type": "string",
            "description": "Manufacturing process specified for the part"
          },
          "notes": {
            "type": "string",
            "description": "Additional notes or instructions for the line item"
          },
          "createdAt": {
            "type": "string",
            "description": "Date and time when the line item was created",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "description": "Date and time when the line item was last updated",
            "format": "date-time"
          },
          "operations": {
            "type": "array",
            "description": "Collection of manufacturing operations applied to this line item",
            "items": {
              "$ref": "#/components/schemas/OrderLineItem_Operation"
            }
          },
          "unitPrice": {
            "type": "number",
            "description": "Price per unit in the order currency, or null if not yet priced",
            "format": "decimal",
            "nullable": true
          },
          "totalPrice": {
            "type": "number",
            "description": "Total price for the line item (unit price × quantity), or null if not yet priced",
            "format": "decimal",
            "nullable": true
          },
          "materialSku": {
            "type": "string",
            "description": "SKU of the material associated with this line item",
            "nullable": true
          },
          "materialDescription": {
            "type": "string",
            "description": "Human-readable description of the material",
            "nullable": true
          },
          "materialCategory": {
            "type": "string",
            "description": "Category classification of the material",
            "nullable": true
          },
          "materialGrade": {
            "type": "string",
            "description": "Grade specification of the material",
            "nullable": true
          },
          "materialShape": {
            "type": "string",
            "description": "Shape classification of the material (e.g., \"sheet\", \"tube\")",
            "nullable": true
          },
          "materialDimensions": {
            "type": "object",
            "description": "Key-value pairs of dimension names and values for the material (e.g., \"thickness\": \"0.25\")",
            "nullable": true,
            "additionalProperties": {
              "type": "string"
            }
          }
        }
      },
      "OrderLineItem_Operation": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "operationType": {
            "type": "string",
            "description": "Type of manufacturing operation (e.g., \"cut\", \"bend\")"
          },
          "operationDetail": {
            "type": "object",
            "description": "Key-value pairs of operation-specific parameters",
            "additionalProperties": {
              "type": "string"
            }
          }
        }
      },
      "ConnectEnvelopeOfSuccessFailureResponse": {
        "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/SuccessFailureResponse"
          },
          "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"
          }
        }
      },
      "SuccessFailureResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "description": "Whether the operation succeeded"
          },
          "message": {
            "type": "string",
            "description": "Human-readable description of the result or failure reason"
          }
        }
      },
      "UpdateOrderDetailsRequest": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "connectIntegrationId": {
            "type": "string",
            "nullable": true
          }
        }
      },
      "UpdateProductCostsRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "costUnitOfMeasure",
          "supplierProductIds"
        ],
        "properties": {
          "cost": {
            "type": "number",
            "format": "decimal",
            "minimum": 0
          },
          "costUnitOfMeasure": {
            "type": "string",
            "minLength": 1,
            "nullable": false
          },
          "supplierProductIds": {
            "type": "array",
            "minLength": 1,
            "nullable": false,
            "items": {
              "type": "string"
            }
          }
        }
      },
      "UpdateProductLimitsRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "productLimits"
        ],
        "properties": {
          "productLimits": {
            "type": "array",
            "minLength": 1,
            "nullable": false,
            "items": {
              "$ref": "#/components/schemas/ProductLimitRequest"
            }
          }
        }
      },
      "ProductLimitRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "supplierProductId",
          "productLimitUnit"
        ],
        "properties": {
          "supplierProductId": {
            "type": "string"
          },
          "productLimit": {
            "type": "number",
            "format": "decimal"
          },
          "productLimitUnit": {
            "type": "string"
          }
        }
      }
    },
    "securitySchemes": {
      "apikey": {
        "type": "apiKey",
        "name": "x-api-key",
        "in": "header"
      }
    }
  },
  "servers": [
    {
      "url": "https://connect.stellasource.com"
    }
  ]
}
