Recommendations

Returns model improvement recommendations generated from a completed evaluation - class-imbalance warnings, missed-detection patterns, and other actionable suggestions for what to add to your dataset or how to retrain.

This is the data the model improvement recommendations panel in the app reads.

This endpoint is read-only. Recommendations are generated as a side effect of training completion (or via the legacy in-app "Refresh Recommendations" action). If they have not yet been generated, the response is 200 {"generated": false} - note that this is not a 409 EVAL_NOT_DONE. The evaluation is done; it just doesn't have the optional recommendations side-output. Other panel endpoints (map-results, confidence-sweep, etc.) return 409 EVAL_NOT_DONE when their backing data is missing because that data is intrinsic to the evaluation; recommendations are not.

https://api.roboflow.com/:workspace/model-evals/:evalId/recommendations

curl "https://api.roboflow.com/my-workspace/model-evals/$EVAL_ID/recommendations?api_key=$ROBOFLOW_API_KEY"

Response (recommendations available)

{
    "generated": true,
    "generatedAt": "2026-04-27T20:05:37.512Z",
    "recommendations": {
        "summary": {
            "confidenceThreshold": 37,
            "split": "test",
            "generatedAt": "2026-04-27T20:05:37.512Z",
            "count": 3,
            "f1": 0.85,
            "precision": 0.85,
            "recall": 0.85
        },
        "items": [
            {
                "id": "56bcd423-38ff-45f9-b3e0-662a71ce44e6",
                "type": "missed_detection",
                "analysis": {
                    "affected_class": "Car-rims",
                    "count": 3
                }
            },
            {
                "id": "150e49a8-3a61-479a-9e18-3eb751494a70",
                "type": "class_imbalance",
                "analysis": {
                    "affected_class": "Car-rims",
                    "current_count": 20,
                    "total_gt_instances": 20,
                    "median_count": 10
                }
            }
        ]
    }
}

Response (not yet generated)

{
    "generated": false
}