Career Roadmaps

Generate tailored learning roadmaps based on a user’s target career goals (e.g. “Smart Contract Auditor”, “AI Engineer”, “DeFi Product Manager”).

Get Current User Roadmap

Retrieves the authenticated user’s current active roadmap, complete with progress tracking and course completion metrics.

Endpoint

GET /api/v2/learning-path/roadmap/me

Headers

Authorization: Bearer <jwt_access_token>

Response (200 OK - Active Roadmap)

{
  "success": true,
  "data": {
    "status": "completed",
    "roadmap": {
      "careerGoal": "Smart Contract Auditor",
      "totalCourses": 12,
      "coursesCompleted": 4,
      "foundationPaths": [
        {
          "id": "path-foundation-1",
          "title": "Digital & Security Literacy",
          "isCompleted": true
        }
      ],
      "specializationPaths": [
        {
          "id": "path-spec-1",
          "title": "Advanced EVM Security & Auditing",
          "requiresSubscription": true,
          "userHasAccess": true
        }
      ]
    }
  }
}

Generate Career Roadmap

Generates a new personalized roadmap for a specified career aspiration.

Endpoint

POST /api/v2/learning-path/roadmap

Request Body

Field	Type	Required	Description
`userId`	`string`	Yes	User UUID
`careerGoal`	`string`	Yes	Target career title or aspiration

{
  "userId": "550e8400-e29b-41d4-a716-446655440000",
  "careerGoal": "Full Stack Web3 Developer"
}

Response (200 OK)

{
  "success": true,
  "data": {
    "careerGoal": "Full Stack Web3 Developer",
    "foundationPaths": [ ... ],
    "specializationPaths": [ ... ]
  },
  "message": "Career path roadmap generated successfully"
}