> ## Documentation Index
> Fetch the complete documentation index at: https://docs.learnway.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Career Roadmaps

> Generate AI-powered career learning roadmaps and retrieve customized curricula.

# 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

```http theme={null}
GET /api/v2/learning-path/roadmap/me
```

### Headers

```http theme={null}
Authorization: Bearer <jwt_access_token>
```

### Response (200 OK - Active Roadmap)

```json theme={null}
{
  "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

```http theme={null}
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 |

```json theme={null}
{
  "userId": "550e8400-e29b-41d4-a716-446655440000",
  "careerGoal": "Full Stack Web3 Developer"
}
```

### Response (200 OK)

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