Predict

The predict phase turns detections into actionable pathways that combine near-term relief with growth opportunities. Given detected blockers, user goals, and expressed curiosities, these endpoints recommend personalized pathways that include immediate habits, learning resources from multiple sources (X.AI news, LinkedIn jobs, YouTube, academic journals), and opportunities that address root causes while reigniting motivation.

Request

json

curl -X POST https://api.stageonego.com/v1/pathways/recommend \
  -H "Authorization: Bearer $STAGEONEGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "persona": "resident_physician",
    "goals": ["stabilize_schedule", "restore_focus"],
    "blockers": ["excessive_workload", "cognitive_friction"],
    "curiosities": ["clinical_reasoning", "peer_support"],
    "sources": [
      "linkedin_jobs",
      "youtube_learning",
      "open_access_journals"
    ],
    "limit": 3
  }'

Response

json

{
  "data": {
    "pathways": [
      {
        "id": "pathway_focus_blocks",
        "title": "Stabilize workload; rebuild sharp thinking",
        "why": "High exhaustion and cognitive friction with interest in clinical reasoning.",
        "actions": [
          {
            "kind": "habit",
            "title": "2 x 15m protected focus blocks per shift",
            "timeline": "today",
            "metric": "minutes_completed"
          },
          {
            "kind": "resource",
            "title": "Cognitive load mini-lecture",
            "provider": "youtube_learning",
            "url": "https://example.com/youtube/cognitive-load"
          },
          {
            "kind": "resource",
            "title": "Clinical reasoning refresher (latest cases)",
            "provider": "open_access_journals",
            "url": "https://example.com/journals/clinical-reasoning"
          },
          {
            "kind": "opportunity",
            "title": "Internal mobility posting (lighter call schedule)",
            "provider": "linkedin_jobs",
            "url": "https://example.com/linkedin/internal-mobility"
          }
        ],
        "confidence": 0.71
      }
    ]
  },
  "meta": {
    "request_id": "req_pathway_123",
    "timestamp": "2024-01-15T10:40:00Z"
  }
}