Get a recommendation

The full recommendation: body, action items, confidence and rationale, linked work items, and its decision and outcome history.

GET/v1/recommendations/{recommendationId}

Example

curl -X GET "https://silent-viper-157.convex.site/v1/recommendations/rec_456" \  -H "Authorization: Bearer $ASKENGINE_API_KEY"

Response

{  "data": {    "recommendationId": "rec_456",    "title": "Add an inline setup checklist",    "body": "A first-run checklist that walks users through key setup steps should cut early drop-off around configuration.",    "lifecycleState": "open",    "workItemLinks": [      {        "url": "https://linear.app/acme/issue/ACM-412",        "provider": "linear",        "externalId": "ACM-412",        "title": "First-run setup checklist",        "linkedAt": 1764710000000      }    ],    "generatedAt": 1764690000000,    "confidence": "high",    "confidenceRationale": "Consistent across three studies with little counter-evidence.",    "actionItems": [      {        "action": "Ship a first-run setup checklist",        "priority": "high",        "supportingEvidence": "6 of 9 participants stalled at the API-key step."      }    ],    "evidenceSnapshot": {      "totalSourceItems": 24,      "studyCount": 3,      "generatedFromEvidenceCount": 8    },    "signals": [      {        "signalId": "sig_123",        "ref": "SIG-14",        "label": "Teams want faster onboarding feedback"      }    ],    "decision": {      "value": "accepted",      "at": 1764700000000,      "note": "Scheduled for next sprint."    }  }}