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.
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 "x-api-key: $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": {
"current_level": "Mid-level Software Engineer",
"target_role": "Engineering Manager",
"estimated_timeline_months": 24,
"milestones": [
{
"role": "Senior Software Engineer",
"timeline_months": 9,
"key_skills_to_develop": ["system design", "technical mentoring", "cross-team collaboration"],
"actions": ["Lead a major feature end-to-end", "Mentor 1–2 junior engineers"]
},
{
"role": "Staff / Tech Lead",
"timeline_months": 18,
"key_skills_to_develop": ["roadmap planning", "stakeholder management", "hiring"],
"actions": ["Own a technical domain", "Drive team-wide architectural decisions"]
},
{
"role": "Engineering Manager",
"timeline_months": 24,
"key_skills_to_develop": ["performance management", "OKR setting", "budget ownership"],
"actions": ["Volunteer for team lead opportunities", "Seek EM sponsorship from current manager"]
}
],
"confidence": { "score": 0.84, "level": "high" }
}
}
}