Get a signal

The full signal packet: the belief and its confidence, supporting and counter-evidence, per-study breakdowns, the recommended next step, open uncertainties, and a timeline of how the belief changed.

GET/v1/signals/{signalId}

Example

curl -X GET "https://example.com/v1/signals/string" \  -H "Authorization: Bearer $ASKENGINE_API_KEY"

Response

{  "data": {    "signalId": "sig_123",    "belief": {      "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": 1764279000000,      "lastUpdated": 1764687600000,      "lockedFields": []    },    "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.",          "relevance": 0.91,          "themeId": "thm_setup",          "themeLabel": "Setup friction",          "studyId": "std_789",          "studyName": "Onboarding interviews Q4",          "sourceItemId": "src_a1",          "participantId": "par_9",          "participantName": "Ada L.",          "timeInCallSecs": 412,          "capturedAt": 1764453600000        }      ],      "distinctParticipants": 6,      "distinctSourceItems": 6,      "studyCount": 3,      "quoteCount": 8,      "freshness": {        "earliestCapturedAt": 1764279000000,        "latestCapturedAt": 1764687600000,        "isStale": false      }    },    "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": "std_789",        "studyName": "Onboarding interviews Q4",        "sourceItemId": "src_b2",        "participantName": "Jon R.",        "capturedAt": 1764540000000      }    ],    "perStudy": [      {        "breakdownId": "brk_1",        "studyId": "std_789",        "studyName": "Onboarding interviews Q4",        "relationship": "supports",        "narrative": "Most participants stumbled at the API-key step.",        "addedAt": 1764540000000,        "keyQuotes": [          {            "sourceItemId": "src_a1",            "participantId": "par_9",            "participantName": "Ada L.",            "quote": "I gave up twice before I figured out where to add my API key."          }        ]      }    ],    "recommendation": {      "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": [],      "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": []    },    "uncertainties": [      {        "uncertaintyId": "unc_77",        "signalId": "sig_123",        "type": "thin_counter_evidence",        "status": "open",        "description": "Few dissenting voices — the belief may be over-weighted to power users.",        "suggestedAction": "Interview 5 first-week users who churned.",        "detectedAt": 1764600000000      }    ],    "studies": [      {        "studyId": "std_789",        "studyName": "Onboarding interviews Q4",        "status": "active"      }    ],    "timeline": [      {        "verb": "appeared",        "at": 1764279000000,        "description": "Signal first detected across onboarding studies.",        "target": {          "kind": "signal",          "id": "sig_123"        },        "actor": "system"      },      {        "verb": "became_established",        "at": 1764600000000,        "description": "Reached established stage as evidence accumulated.",        "target": {          "kind": "signal",          "id": "sig_123"        },        "actor": "system"      }    ]  }}