Liya Engine

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

FieldTypeNotes
input.user_idstringYour platform's user ID
input.profileProfileInputPrimary source for the rewrite — work experience, skills, career stories

Optional inputs

FieldTypeNotes
input.resumeResumeInputReference text to preserve formatting style
input.job_descriptionJobDescriptionInputTailors improvements to a specific role
input.career_goalsCareerGoalsInputAligns 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"
  }
}

On this page