ask/engine
API

Record an outcome

Mark an accepted recommendation shipped, validated, or stale. Recording validated closes the loop: the linked signals are archived in the same call, and the recommendation is archived with them (its validated outcome is preserved).

POST/v1/recommendations/{recommendationId}/outcome

Example

curl -X POST "https://silent-viper-157.convex.site/v1/recommendations/rec_456/outcome" \  -H "Authorization: Bearer $ASKENGINE_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "outcome": "shipped"  }'

Request Body

outcomestring
Valuesshipped, validated, stale
note?string

Response

{  "data": {    "recommendationId": "rec_456"  }}