Why (Root-Cause Analysis) API

POST /v1/cofounder/why
GET  /v1/cofounder/why/reports
GET  /v1/cofounder/why/reports/:id

curl -X POST https://api.appeeky.com/v1/cofounder/why \
  -H "X-API-Key: $KEY" -H "Content-Type: application/json" \
  -d '{
    "appId": "6479581124",
    "metricPath": "asc.revenue",
    "timeRange": { "from": "2026-06-01T00:00:00Z", "to": "2026-07-01T00:00:00Z" },
    "userQuestion": "Why did US revenue drop after v2.4?"
  }'

{ "data": { "triggered": true, "triggerRunId": "run_abc123" } }

curl "https://api.appeeky.com/v1/cofounder/why/reports?appId=6479581124&limit=20" -H "X-API-Key: $KEY"

{
  "data": {
    "reports": [
      {
        "id": "uuid",
        "app_id": "6479581124",
        "metric_path": "asc.revenue",
        "user_question": "Why did US revenue drop after v2.4?",
        "signal_id": null,
        "llm_tokens": 9214,
        "cost_usd": 0.011,
        "duration_ms": 48210,
        "created_at": "2026-07-01T10:00:00Z",
        "cache_until": "2026-07-02T10:00:00Z"
      }
    ]
  }
}

curl https://api.appeeky.com/v1/cofounder/why/reports/<id> -H "X-API-Key: $KEY"

{
  "data": {
    "report": {
      "id": "uuid",
      "metric_path": "asc.revenue",
      "report": {
        "observation": "US revenue fell 34% between Jun 2 and Jun 9...",
        "candidateCauses": [
          {
            "summary": "v2.4 removed the onboarding discount",
            "likelihood": "very_likely",   // very_likely | likely | possible | unlikely
            "evidenceFor": ["Drop starts within 24h of v2.4 rollout", "..."],
            "evidenceAgainst": ["Trial starts unchanged"]
          }
        ],
        "topPick": {
          "summary": "v2.4 removed the onboarding discount",
          "confidence": 0.78,
          "nextStep": "Restore the intro offer for US and re-measure over 7 days",
          "openHypothesisId": null
        },
        "analystNotes": "ASA spend was flat throughout — paid traffic ruled out."
      }
    }
  }
}