Resume Improvement
Rewrite and enhance resume content using the candidate's profile and career stories, optionally tailored to a target role.
POST /v1/hiring/resume-improvement
Generates an enhanced version of a resume by rewriting bullets to include quantified impact, integrating career stories in STAR format, improving ATS keyword coverage, and restructuring sections for clarity.
Required inputs
| Field | Type | Notes |
|---|---|---|
input.user_id | string | Your platform's user ID |
input.profile | ProfileInput | Primary source for the rewrite — work experience, skills, career stories |
Optional inputs
| Field | Type | Notes |
|---|---|---|
input.resume | ResumeInput | Reference text to preserve formatting style |
input.job_description | JobDescriptionInput | Tailors improvements to a specific role |
input.career_goals | CareerGoalsInput | Aligns tone and emphasis with career direction |
Example request
curl -X POST https://api.liyaengine.ai/v1/hiring/resume-improvement \
-H "x-api-key: $LIYA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"user_id": "usr_123",
"profile": {
"title": "Senior Software Engineer",
"years_of_experience": 8,
"skills": ["TypeScript", "React", "Node.js", "PostgreSQL"],
"work_experiences": [
{
"title": "Senior Engineer",
"company": "Acme Corp",
"start_date": "2020-01-01",
"end_date": null,
"achievements": ["Led migration to microservices"]
}
],
"career_stories": [
{
"title": "Microservices migration",
"context": "Monolith was causing 3s p99 latency",
"decision": "Led 6-month decomposition into 12 services",
"outcome": "Reduced p99 latency by 73%, unblocked 2 new product lines",
"metric_value": "73%",
"metric_type": "latency reduction",
"metric_direction": "down"
}
]
},
"job_description": {
"title": "Staff Engineer",
"description": "Looking for a staff engineer to own platform architecture..."
}
}
}'Response
{
"success": true,
"data": {
"output": {
"enhanced_text": "Jane Doe\nStaff Engineer candidate\n\nExperience:\nSenior Engineer — Acme Corp (2020–present)\n• Led 6-month decomposition of monolith into 12 microservices, reducing p99 latency by 73% and unblocking 2 new product lines\n...",
"sections": [
{
"section_name": "Experience",
"original_length": 320,
"enhanced_length": 480,
"improvements_applied": ["Added metrics", "STAR format", "Keyword alignment"]
}
],
"improvements_summary": {
"total_changes": 14,
"categories": ["Added metrics", "Enhanced bullets", "STAR format", "Keyword coverage"],
"readability_score": 84
},
"career_stories_used": 1,
"actions": [
{ "id": "download_resume", "label": "Download resume", "primary": true }
],
"confidence": { "score": 0.88, "level": "high" }
},
"session_id": "ses_abc",
"message_id": "msg_xyz"
}
}