Career Path Planning
Generate multi-step career progression recommendations from a candidate's current position toward their goals.
POST /v1/hiring/career-path-planning
Produces a structured career roadmap with role milestones, skill development priorities, and timeline estimates based on the candidate's current profile and stated goals. It shares its output shape with skill-gap-analysis — milestones are expressed as skill_gaps and learning_path entries toward the target role.
Required inputs
| Field | Type | Notes |
|---|---|---|
input.user_id | string | Your platform's user ID |
input.profile | ProfileInput | Current role, skills, and experience |
Optional inputs
| Field | Type | Notes |
|---|---|---|
input.resume | ResumeInput | Resume text for additional depth |
input.career_goals | CareerGoalsInput | Target role, timeline, priorities |
Example request
curl -X POST https://api.liyaengine.ai/v1/hiring/career-path-planning \
-H "Authorization: Bearer $LIYA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"user_id": "usr_123",
"profile": {
"title": "Software Engineer",
"years_of_experience": 3,
"experience_level": "mid",
"skills": ["Python", "Django", "PostgreSQL"]
},
"career_goals": {
"target_role": "Engineering Manager",
"timeline": "2_years",
"priorities": ["leadership", "growth"]
}
}
}'Response
{
"success": true,
"data": {
"output": {
"target_role": "Engineering Manager",
"overall_readiness": {
"overall_score": 52,
"confidence": { "score": 0.84, "level": "high" },
"components": [
{ "name": "Leadership Experience", "score": 45, "weight": 0.4, "feedback": "Some mentoring, no formal people-management scope yet." }
],
"interpretation": {
"level": "developing",
"summary": "A 2-year path through Senior and Staff/Tech Lead scope before EM readiness."
}
},
"skill_gaps": [
{
"skill": "technical mentoring",
"current_level": "basic",
"target_level": "advanced",
"gap_severity": "important",
"importance_for_goal": 80,
"estimated_time_to_close": "6-9 months",
"learning_resources": [],
"practice_suggestions": ["Mentor 1-2 junior engineers formally"]
},
{
"skill": "performance management",
"current_level": "none",
"target_level": "intermediate",
"gap_severity": "critical",
"importance_for_goal": 90,
"estimated_time_to_close": "12-18 months",
"learning_resources": [],
"practice_suggestions": ["Seek EM sponsorship from current manager"]
}
],
"learning_path": [
{ "phase": "Months 1-9", "focus_area": "Senior Software Engineer", "skills_to_develop": ["system design", "technical mentoring", "cross-team collaboration"], "milestones": ["Lead a major feature end-to-end"], "time_commitment": "ongoing on-the-job" },
{ "phase": "Months 9-18", "focus_area": "Staff / Tech Lead", "skills_to_develop": ["roadmap planning", "stakeholder management", "hiring"], "milestones": ["Own a technical domain"], "time_commitment": "ongoing on-the-job" },
{ "phase": "Months 18-24", "focus_area": "Engineering Manager", "skills_to_develop": ["performance management", "OKR setting", "budget ownership"], "milestones": ["Take on formal reports"], "time_commitment": "ongoing on-the-job" }
],
"quick_wins": [
{ "action": "Volunteer for team lead opportunities", "impact": "Visible leadership signal for EM candidacy", "time_required": "ongoing" }
],
"timeline": {
"estimated_total_time": "24 months",
"readiness_projection": [
{ "date": "2026-09-01", "projected_readiness": 52 },
{ "date": "2028-09-01", "projected_readiness": 90 }
]
},
"actions": [
{ "action_id": "skill_gap_analysis", "action_type": "secondary", "title": "View detailed skill gaps", "priority": 2 }
],
"confidence": { "score": 0.84, "level": "high" }
}
}
}