PRprototyping
surface_finishes

Create Surface Finish

Create (or replace) a surface-finish annotation on a part's latest CAD version.

Re-authoring on a face that already has a live finish flips the existing row to state="undone" and inserts the replacement — Fusion-360 muscle memory: re-clicking a finished face updates, it does not duplicate.

post/api/v1/parts/{part_id}/surface-finishes

Request

Path parameters

part_idstring uuid required

Request body

feature_idstring required

Topology face ID of form face_N — looked up in the topology sidecar JSON.

finish_typestring required

One of SURFACE_FINISH_TYPES.

ra_umnumber nullable

Surface roughness in micrometers (Ra). Optional.

custom_color_hexstring nullable

Optional user-chosen tint (6-char hex). Overrides the default palette. Relevant for anodize_colored, powder_coat, paint.

notesstring nullable

Response

Successful Response

idstring uuid required
part_idstring uuid required
cad_file_version_idstring uuid nullable required
feature_idstring required
finish_typestring required
ra_umnumber nullable required
custom_color_hexstring nullable required
notesstring nullable required
labelstring required
statestring required
sourcestring required
authorstring nullable required
created_bystring uuid nullable required
created_atstring date-time required
updated_atstring date-time nullable required
is_process_mismatchboolean

Changes

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