Update Recommendation Outcome

PATCH/v1/core/recommends/{id}/feedback

Closes the machine learning feedback loop. When you request a recommendation, you receive a recommendation_id. After attempting an action based on that recommendation, you should update the recommendation to say whether you followed the advice or ignored it, and optionally what the final interaction outcome was.

Request

{
  "was_followed": true,
  "outcome_interaction_id": "int_3A21F5..."
}

Parameters

Name	Type	Required	Description
id	string	Yes	(In Path) The Recommendation UUID
was_followed	boolean	Yes	Did your agent execute the primary recommended action?
outcome_interaction_id	string	No	UUID of the actual logged interaction resulting from this decision

Response

{
  "recommendation_id": "rec_01A2B3C",
  "was_followed": true,
  "outcome": "success",
  "updated_at": "2026-03-04T12:05:00Z"
}