Get a signal

The full signal packet: the belief and its confidence, supporting and counter-evidence, per-study breakdowns, the recommended next step, and open research gaps.

GET/v1/signals/{signalId}

Example

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

Response

{  "data": {    "signalId": "sig_123",    "belief": {      "ref": "SIG-14",      "label": "Teams want faster onboarding feedback",      "description": "Recent studies show repeated friction around setup and first-run clarity.",      "trajectory": "rising",      "stage": "established",      "confidence": 0.78,      "firstSeen": 1756911600000,      "lastUpdated": 1764687600000,      "confidenceBand": "moderate",      "archived": false,      "actionable": true    },    "implication": "Onboarding is the highest-leverage place to reduce early churn.",    "recommendedNextStep": {      "type": "act",      "recommendationId": "rec_456",      "title": "Add an inline setup checklist",      "topAction": {        "action": "Ship a first-run checklist",        "priority": "high"      }    },    "evidence": {      "items": [        {          "evidenceId": "ev_001",          "kind": "evidence",          "quote": "I gave up twice before I figured out where to add my API key.",          "themeId": "thm_setup",          "themeLabel": "Setup friction",          "studyId": "study_789",          "studyName": "Onboarding interviews Q4",          "sourceItemId": "src_a1",          "participantName": "Ada L.",          "timeInCallSecs": 412,          "capturedAt": 1764453600000        }      ],      "distinctSourceItems": 6,      "studyCount": 3,      "quoteCount": 8,      "counterEvidenceCount": 1,      "freshness": {        "latestCapturedAt": 1764687600000,        "isStale": false      },      "distinctParticipants": 6    },    "counterEvidence": [      {        "evidenceId": "ev_014",        "kind": "counterEvidence",        "quote": "Setup was fine for me — the docs were clear.",        "note": "Experienced user; had integrated a similar tool before.",        "themeId": "thm_setup",        "themeLabel": "Setup friction",        "studyId": "study_789",        "studyName": "Onboarding interviews Q4",        "sourceItemId": "src_b2",        "participantName": "Jon R.",        "capturedAt": 1764540000000      }    ],    "perStudy": [      {        "studyId": "study_789",        "studyName": "Onboarding interviews Q4",        "relationship": "supports",        "narrative": "Most participants stumbled at the API-key step.",        "addedAt": 1764540000000      }    ],    "recommendation": {      "recommendationId": "rec_456",      "title": "Add an inline setup checklist",      "lifecycleState": "open"    },    "researchGaps": [      {        "researchGapId": "gap_77",        "type": "thin_counter_evidence",        "status": "open"      }    ]  }}