Skip to main content

Apply a calibration recommendation as a new condition version

POST 
/conditions/apply-calibration

Consume a calibration_token and create a new immutable condition version using the recommended parameters stored in the token.

The token is single-use and expires 24 hours after generation. Calling this endpoint invalidates the token atomically — concurrent calls with the same token return HTTP 400 for all but the first.

Does NOT automatically rebind tasks. tasks_pending_rebind in the response lists tasks still referencing the previous condition version — the caller must rebind them explicitly via PATCH /tasks/{id}.

new_version is optional. When absent, the service auto-increments the source version (e.g. '1.0' → '1.1').

HTTP 400 — calibration_token is invalid, expired, or already used.

Request​

Responses​

Successful Response