v4

latestOpenAPI 3.0.32026-08-024840393.1 KB

Files

Get printers ranked by compatibility with a file

Returns all printers in the organization ranked by their compatibility with the specified model file. Considers printer model, available filament slots, and material matching with color proximity.

get/v1/files/{fileId}/compatible-printers

Path parameters

fileIdstring uuid required

The model file ID

Query parameters

organizationIdstring uuid

Organization ID (uses default if not provided)

includeOffline'true' | 'false'

Include offline printers in results

makeIdstring uuid

Make ID to use for exact material matching via make_materials

colorThresholdstring

Delta-E threshold for color proximity matching (0-100)

materialIdsstring

JSON array of {index, materialId} for explicit material requirements

acceptableMaterialsstring

JSON array of acceptable material-set options: {optionId, label?, materialIds:[{index, materialId}]}

strategyExactMaterial'true' | 'false'

Enable exact material ID matching strategy

strategyTypeColor'true' | 'false'

Enable type + color matching strategy

strategyLooseMatch'true' | 'false'

Enable loose (type only) matching strategy

Response

Default Response