Sign in
admin-cad-files

Get Cad File Detail

Get full CAD file version details including geometry analysis data.

Returns all fields from the CadFileVersion record including dimensions, volume, DFM issues, and presigned URLs for converted files. Requires projects:view permission.

The detected_features blob is filtered against the part's selected manufacturing process (so a sheet metal part doesn't show CNC-only features and vice versa). Pass ?unfiltered=true to skip the filter — the admin part viewer panel does this so its in-page "Show all" toggle can flip without invalidating the TanStack Query cache.

get/api/v1/admin/cad-files/{cad_file_id}

Path parameters

cad_file_idstring uuid required

Query parameters

unfilteredboolean

Skip process-aware feature filtering. Admin escape hatch — the admin app passes this by default so the panel-side toggle can re-derive without re-fetching.

Skip process-aware feature filtering. Admin escape hatch — the admin app passes this by default so the panel-side toggle can re-derive without re-fetching.

Response

Successful Response

idstring uuid required
version_numberinteger required
is_latestboolean required
file_namestring required
original_file_namestring required
file_formatstring required
file_sizeinteger required
statusstring required
processing_stepstring nullable
failure_reasonstring nullable
latest_run_idstring uuid nullable
analysis_milestonestring nullable
analysis_authoritystring nullable
analysis_seqinteger nullable
glb_urlstring nullable
thumbnail_urlstring nullable
topology_urlstring nullable
widthstring nullable
heightstring nullable
depthstring nullable
dimension_unitstring
volumestring nullable
surface_areastring nullable
wall_thickness_minstring nullable
is_manifoldboolean nullable
mesh_quality_scorenumber nullable
dfm_issuesobject nullable
geometry_metadataobject nullable
detected_featuresobject nullable
feature_projection_v2object nullable
process_dfm_resultsobject nullable
dfm_scorestring nullable
ai_dfm_synthesisobject nullable
analysis_status'not_started' | 'pending_cad' | 'computing' | 'complete' | 'failed'

Single source of truth for deterministic DFM/pricing readiness.

Replaces the fragile inference from dfm_pending + process_dfm_results

  • ai_dfm_synthesis. See .claude/plans/active/dfm-cost-stuck-state-elimination.md.

NOT_STARTED: No specs set yet. PENDING_CAD: Specs set, CAD pipeline still running — finalize will pick up. COMPUTING: DFM rule engine / pricing refresh in flight. COMPLETE: DFM and pricing written; AI/Ollie synthesis is optional. FAILED: See analysis_error_message + analysis_failed_step.

analysis_error_messagestring nullable
analysis_failed_stepstring nullable
error_messagestring nullable
notesstring nullable
part_idstring uuid required
created_atstring date-time required
updated_atstring date-time required
lane_a_factsobject nullable

Changes

No recorded changes to this endpoint across all 1 revision of this API.