POST /v1/maintenance/recommend

Difficulty-adapted intervention recommendation for one operator.

What this is

Returns the single intervention most likely to arrest judgment decay for the named operator, adapted to their current JIS and weakest dimension.

When to use

Threshold-triggered (JIS drops below 75), scheduled (per shift), or event-driven (right after a critical error).

Request

curl -X POST https://api.cohesionauth.com/v1/maintenance/recommend \
  -H "X-API-Key: $COHESION_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"operator_id": "analyst-42"}'

Python

rec = client.maintenance_recommend(operator_id="analyst-42")

TypeScript

const rec = await client.maintenanceRecommend({ operator_id: "analyst-42" });

Response (abridged)

{
  "recommendation": {
    "intervention_type": "calibration_injection",
    "target_dimension": "error_detection",
    "difficulty": "moderate",
    "frequency_ratio": 0.05
  },
  "exercises": [
    { "id": "ex_01H...", "title": "Subtle misattribution of source data", "payload": { "...": "..." } }
  ],
  "request_id": "req_01H...",
  "timestamp": "2026-04-22T18:22:10.432Z"
}

Errors

Next step

Guide: maintain judgment quality.