Skip to main content

Generate calibration recommendation for a condition

POST 
/conditions/calibrate

Analyse stored feedback and/or a target alert volume to recommend adjusted parameters.

Always returns HTTP 200 — inspect the status field: recommendation_available — calibration_token + recommended_params populated. no_recommendation — no_recommendation_reason populated.

Returns no_recommendation when:

  • Strategy is 'equals' (no numeric parameter to adjust).
  • Insufficient feedback records (fewer than MIN_FEEDBACK_THRESHOLD).
  • Adjustment would violate guardrail bounds and on_bounds_exceeded='reject'.

Does NOT modify the existing condition. Call POST /conditions/apply-calibration with the returned calibration_token to create a new version.

HTTP 404 — condition (id, version) not found.

Request​

Responses​

Successful Response