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://example.com/v1/recommendations/string" \  -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,        "linkedByUserId": "user_1"      }    ],    "generatedAt": 1764690000000,    "confidence": "strong",    "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    },    "lockedFields": [],    "signalIds": [      "sig_123"    ],    "decision": {      "value": "accepted",      "at": 1764700000000,      "byUserId": "user_1",      "note": "Scheduled for next sprint."    }  }}