v2

latestOpenAPI 3.0.42026-08-084694591.6 MB
Tool

Publish a new calibration template version for a tool. Template versions are append-only and immutable: this becomes the tool's new latest version, prior versions remain readable history, and existing calibration records stay pinned to the version they were measured against. Reference gages never take a calibration template. Publishes are not idempotent: a retried request publishes another version — check the latest version before re-sending after a timeout.

post/api/tools/{toolId}/calibration-template

Path parameters

toolIdstring required

Request body

procedureNamestring nullable

The name of the calibration procedure

defaultMasterGageIdstring nullable

The id of the master gauge tool applied to checkpoints that don't specify their own

lowerTolerancenumber double nullable

The default lower tolerance applied to checkpoints

lowerTolPrecisioninteger nullable

The decimal precision of the lower tolerance

upperTolerancenumber double nullable

The default upper tolerance applied to checkpoints

upperTolPrecisioninteger nullable

The decimal precision of the upper tolerance

trialsPerCheckpointinteger nullable

How many trials each checkpoint requires per phase; between 1 and 100 when specified

minTempDegCnumber double nullable

The minimum acceptable ambient temperature (deg C) during calibration

maxTempDegCnumber double nullable

The maximum acceptable ambient temperature (deg C) during calibration

maxRelHumiditynumber double nullable

The maximum acceptable ambient relative humidity (%) during calibration

instructionsstring nullable

Free-text calibration instructions

Response

The published template version, with its assigned version number and checkpoint ids

idstring uuid

The id of the template version

toolIdstring nullable

The id of the tool this template belongs to

versioninteger

The template version number; calibration records pin the version they were measured against

createdUtcstring date-time

When this version was created (UTC)

source'user' | 'vendor' | 'customer'

Who performed the calibration. Mirrors FulcrumProduct.Domain.ToolCalibrations.CalibrationSource by underlying value.

procedureNamestring nullable

The name of the calibration procedure

defaultMasterGageIdstring nullable

The raw default-master id. Set while defaultMasterGage is null means the configured master no longer resolves ("master unavailable"), never "no master configured"

lowerTolerancenumber double nullable

The default lower tolerance applied to checkpoints

lowerTolPrecisioninteger nullable

The decimal precision of the lower tolerance

upperTolerancenumber double nullable

The default upper tolerance applied to checkpoints

upperTolPrecisioninteger nullable

The decimal precision of the upper tolerance

trialsPerCheckpointinteger nullable

How many trials each checkpoint requires per phase

minTempDegCnumber double nullable

The minimum acceptable ambient temperature (deg C) during calibration

maxTempDegCnumber double nullable

The maximum acceptable ambient temperature (deg C) during calibration

maxRelHumiditynumber double nullable

The maximum acceptable ambient relative humidity (%) during calibration

instructionsstring nullable

Free-text calibration instructions