# CAD Mesh API

*/Software/CAD_Mesh_API*

## Solution Overview

CAD Mesh API ingests heavy parametric CAD files, such as STEP, IGES, and native SolidWorks formats, and returns lightweight, real-time-ready polygonal meshes. The API automatically resolves common topological errors by sealing non-manifold edges, unifying flipped normals, and decimating polygon counts based on target file size constraints. The output is a watertight glTF or OBJ file optimized directly for WebGL rendering or physics simulation without manual geometry cleanup.

Spatial computing developers and industrial e-commerce platforms integrate this API to automate their 3D asset pipelines. Instead of relying on technical artists to manually retopologize engineering models for web configurators, frontend applications send the raw manufacturing files to the endpoint and receive the decimated mesh seconds later. This removes the bottleneck of manual asset preparation, allowing platforms to instantly visualize thousands of SKUs from existing product lifecycle databases.

As a headless infrastructure primitive, CAD Mesh API sits between enterprise product lifecycle management systems and frontend rendering applications. It consumes raw geometric data from cloud storage buckets or directly via webhooks from engineering software like Siemens Teamcenter. The resulting optimized meshes are immediately consumed by automated quoting agents, spatial visualization tools, or web-based product configurators that require high-performance rendering at strict sub-megabyte file size limits.

## Headless Saas Data Model

**Entities**:
- Name: MeshJob · Description: A processing task that converts a raw CAD file into an optimized polygonal mesh
- Name: SourceModel · Description: The uploaded raw engineering CAD file in STEP, IGES, or SolidWorks format
- Name: OptimizedMesh · Description: The lightweight, watertight glTF or OBJ file outputted for WebGL rendering
- Name: ConversionProfile · Description: Reusable settings for polygon decimation limits, normal unification, and target sizes
- Name: Workspace · Description: The tenant scope for CAD assets, processing jobs, and automation profiles
**Relations**:
- To: Workspace · From: MeshJob · Label: belongs to · Cardinality: one-to-many
- To: Workspace · From: SourceModel · Label: belongs to · Cardinality: one-to-many
- To: Workspace · From: ConversionProfile · Label: belongs to · Cardinality: one-to-many
- To: SourceModel · From: MeshJob · Label: processes · Cardinality: one-to-many
- To: ConversionProfile · From: MeshJob · Label: configured by · Cardinality: one-to-many
- To: MeshJob · From: OptimizedMesh · Label: generated from · Cardinality: one-to-one
**Tenant Anchor**: Workspace
**Primary Resource**: MeshJob

## Api Definition

**Protocols**:
- REST
- SDK
- MCP
- Webhooks
**Consumed By**:
- [Automated Quoting Agent](/Agents/Automated_Quoting_Agent)
- [Spatial Configuration Agent](/Agents/Spatial_Configuration_Agent)
- [Manufacturing Triage Agent](/Agents/Manufacturing_Triage_Agent)
**Integrations**:
- [Siemens Teamcenter](/Products/Siemens_Teamcenter)
- [AWS S3](/Products/AWS_S3)
- [SolidWorks](/Products/SolidWorks)
**Consumption Model**: An agent registers the MCP server to submit a SourceModel, triggers a MeshJob specifying a ConversionProfile, and subscribes to the Workspace webhook to download the resulting OptimizedMesh.
**Workflow Wrappers**:
- Name: Process CAD to Mesh · Wraps: Registers a SourceModel, executes a MeshJob against a ConversionProfile, and returns the OptimizedMesh.
- Name: Bulk Process PLM Assets · Wraps: Ingests bulk SourceModels from storage, orchestrates parallel MeshJobs, and pushes completion webhooks.

## Api Function Cascade

**Ai Role**: The CAD Mesh API operates as a fully digital, stateless pipeline where deterministic parsing and agentic decimation loops execute end-to-end, requiring a human-in-the-loop only on exception to review and resolve severe structural gaps that fail heuristic automated repair.
**Cascade**:
- Kind: Code · Note: Fetches raw CAD files via integrations like Siemens Teamcenter or AWS S3. · Step: Ingest Source Asset · Verb: ingest · Realizes: Retrieve Digital Assets · Oversight: none
- Kind: Code · Note: Extracts exact geometric surface definitions from the proprietary CAD format. · Step: Parse Boundary Representation · Verb: extract · Realizes: Process Structural Data · Oversight: none
- Kind: Agentic · Note: Tool loop continually evaluates and reduces polygon count against the conversion profile. · Step: Iterate Mesh Decimation · Verb: optimize · Realizes: Optimize Model Geometry · Oversight: none
- Kind: Generative · Note: Heuristically closes holes and non-manifold edges, flagging severe unhealable gaps. · Step: Heal Manifold Geometry · Verb: repair · Realizes: Resolve Structural Deviations · Oversight: review-on-exception
- Kind: Code · Note: Pushes the completed OptimizedMesh payload to the subscribing downstream agent. · Step: Emit Delivery Webhook · Verb: emit · Realizes: Distribute System Notifications · Oversight: none
**Optimizes**:
- [Mesh Conversion Success Rate](/Metrics/Mesh_Conversion_Success_Rate)
- [Polygon Reduction Ratio](/Metrics/Polygon_Reduction_Ratio)
- [Conversion Processing Latency](/Metrics/Conversion_Processing_Latency)
- [Geometric Deviation Tolerance](/Metrics/Geometric_Deviation_Tolerance)

## Headless Saas Representative Offer

**Warranty**: Maintains a 99.9% API availability SLA with guaranteed job timeouts, providing pro-rated account credits for unrecoverable MeshJob conversion failures.
**Price Band**: ~$0.05 to $2.50 per completed MeshJob, scaling predictably based on SourceModel file size and the complexity of the requested ConversionProfile.
**Pricing Kind**: UsageMeter
**Deliverables**:
- Programmatic access to the CAD Mesh REST API and MCP server endpoints
- OptimizedMesh output artifacts configured for spatial or quoting applications
- Execution of custom ConversionProfiles for targeted mesh decimation
- Webhook notifications for asynchronous bulk PLM asset processing
**Delivery Mode**: Instant self-serve API access where an agent registers the MCP server or provisions API keys, with consumption metered automatically upon job execution.
**Business Function**: ProvideService
**Agent Checkout Support**:
- agentic-commerce-protocol
- stored-credential

## Headless Saas Crud Surface

**Auth Model**: API Key
**Endpoints**:
- GET /mesh-jobs — list mesh processing jobs
- POST /mesh-jobs — create a new mesh processing job
- GET /mesh-jobs/{id} — fetch a specific mesh job
- PATCH /mesh-jobs/{id} — update a mesh job
- POST /mesh-jobs/{id}/cancel — cancel a running mesh job
- GET /mesh-jobs/{id}/optimized-mesh — retrieve the generated optimized mesh
- GET /source-models — list raw engineering CAD files
- POST /source-models — register an uploaded raw CAD file
- GET /source-models/{id} — fetch a specific source model
- PATCH /source-models/{id} — update source model metadata
- GET /source-models/{id}/mesh-jobs — list processing jobs for this source model
- GET /optimized-meshes — list all optimized meshes
- POST /optimized-meshes — create a new optimized mesh record directly
- GET /optimized-meshes/{id} — fetch a specific optimized mesh
- PATCH /optimized-meshes/{id} — update optimized mesh properties
- GET /conversion-profiles — list reusable conversion settings
- POST /conversion-profiles — create a conversion profile
- GET /conversion-profiles/{id} — fetch a specific conversion profile
- PATCH /conversion-profiles/{id} — update a conversion profile
- GET /conversion-profiles/{id}/mesh-jobs — list jobs using this conversion profile
- GET /workspaces — list tenant workspaces
- POST /workspaces — create a new workspace
- GET /workspaces/{id} — fetch a specific workspace
- PATCH /workspaces/{id} — update a workspace
- GET /workspaces/{id}/mesh-jobs — list all mesh jobs in a workspace
- GET /workspaces/{id}/source-models — list all source models in a workspace
- GET /workspaces/{id}/conversion-profiles — list all conversion profiles in a workspace
**Multitenancy**: Row-level isolation
**Webhook Events**:
- mesh_job.started
- mesh_job.completed
- mesh_job.failed
- optimized_mesh.generated

## Headless Saas Erd

```mermaid
erDiagram
    Workspace {
        UUID id PK "tenant key"
        VARCHAR name
        VARCHAR webhookEndpoint
        TIMESTAMP createdAt
    }
    MeshJob {
        UUID id PK
        UUID workspaceId FK
        UUID sourceModelId FK
        UUID conversionProfileId FK
        VARCHAR status
        TIMESTAMP startedAt
    }
    SourceModel {
        UUID id PK
        UUID workspaceId FK
        VARCHAR filename
        VARCHAR format
        VARCHAR storageUrl
        DECIMAL sizeBytes
    }
    OptimizedMesh {
        UUID id PK
        UUID meshJobId FK
        VARCHAR format
        VARCHAR downloadUrl
        DECIMAL polygonCount
        BOOLEAN isWatertight
    }
    ConversionProfile {
        UUID id PK
        UUID workspaceId FK
        VARCHAR name
        VARCHAR targetFormat
        DECIMAL maxSizeBytes
        BOOLEAN unifyNormals
    }
    MeshJob }o--|| Workspace : "belongs to"
    SourceModel }o--|| Workspace : "belongs to"
    ConversionProfile }o--|| Workspace : "belongs to"
    MeshJob }o--|| SourceModel : "processes"
    MeshJob }o--|| ConversionProfile : "configured by"
    OptimizedMesh ||--|| MeshJob : "generated from"
```

## Neighborhood

### Composed into

- [Aband](/Startups/Aband) — composes · Startups

### What it uses

- [Teamcenter](/Products/Teamcenter) — uses · Products
- [Dassault Systemes SolidWorks](/Products/Dassault_Systemes_SolidWorks) — uses · Products
- [AWS S3](/Products/AWS_S3) — uses · Products

### Optimizes

- [Geometric Deviation Tolerance](/Metrics/Geometric_Deviation_Tolerance) — optimizes · Metrics
- [Mesh Conversion Success Rate](/Metrics/Mesh_Conversion_Success_Rate) — optimizes · Metrics
- [Conversion Processing Latency](/Metrics/Conversion_Processing_Latency) — optimizes · Metrics
- [Polygon Reduction Ratio](/Metrics/Polygon_Reduction_Ratio) — optimizes · Metrics

### Who consumes this

- [Manufacturing Triage Agent](/Agents/Manufacturing_Triage_Agent) — consumed by · Agents
- [Spatial Configuration Agent](/Agents/Spatial_Configuration_Agent) — consumed by · Agents
- [Automated Quoting Agent](/Agents/Automated_Quoting_Agent) — consumed by · Agents

### Similar Startups

- [Kerfarc](/Startups/Kerfarc) — similar · Startups
- [Shapeworks](/Startups/Shapeworks) — similar · Startups
- [Closetforge](/Startups/Closetforge) — similar · Startups
- [Sprue](/Startups/Sprue) — similar · Startups
- [Wearlane](/Startups/Wearlane) — similar · Startups
- [Shapyard](/Startups/Shapyard) — similar · Startups
- [Outfitter](/Startups/Outfitter) — similar · Startups
- [Dawnatelier](/Startups/Dawnatelier) — similar · Startups
- [Apparelrealm](/Startups/Apparelrealm) — similar · Startups
- [Cadescue](/Startups/Cadescue) — similar · Startups

### Similar Software

- [BIM Software](/Metrics/Schematic_Conversion_Time/Software/BIM_Software) — similar · Software
- [CFD Simulation API](/Software/CFD_Simulation_API) — similar · Software
- [Siemens Teamcenter](/Metrics/Design_Defect_Rate/Problems/Design_Iteration_Delays/Competitors/Ansys_Mechanical/Software/Siemens_Teamcenter) — similar · Software
- [PTC Creo](/Metrics/Design_Defect_Rate/Problems/Design_Iteration_Delays/Competitors/Altair_Inspire/Software/PTC_Creo) — similar · Software
- [Siemens Teamcenter](/Metrics/Design_Defect_Rate/Problems/Design_Iteration_Delays/Competitors/Altair_Inspire/Software/Siemens_Teamcenter) — similar · Software
- [Automated Drafting Software](/Metrics/Schematic_Conversion_Time/Software/Automated_Drafting_Software) — similar · Software
- [ECAD Software](/Metrics/Schematic_Conversion_Time/Software/ECAD_Software) — similar · Software
- [PTC Creo](/Metrics/Design_Defect_Rate/Problems/Design_Iteration_Delays/Competitors/Ansys_Mechanical/Software/PTC_Creo) — similar · Software
- [RFQ Payload Generator](/Software/RFQ_Payload_Generator) — similar · Software

### Similar Agents

- [Block Rendering Worker](/Agents/Block_Rendering_Worker) — similar · Agents