---
title: "Analyze resume and persist latest analysis"
method: POST
path: "/ai/analyze-resume"
tags: ["AI"]
---

# Analyze resume and persist latest analysis

`POST /ai/analyze-resume`

Uses AI to analyze the current resume and returns a structured analysis with scorecard, strengths, and improvement suggestions. The latest analysis is persisted and can be fetched later. Requires authentication and AI credentials.

## Request body

- object
  - `aiProviderId` string
  - `resumeId` string, required

## Response `200`

Structured resume analysis returned and persisted successfully.

- object
  - `overallScore` integer, required
  - `scorecard` object[], required
    - `dimension` string, required
    - `score` integer, required
    - `rationale` string, required
  - `suggestions` object[], required
    - `title` string, required
    - `impact` 'high' | 'medium' | 'low', required
    - `why` string, required
    - `exampleRewrite` string, nullable, required
    - `copyPrompt` string, required
  - `strengths` string[], required
  - `updatedAt` string, date-time, required
  - `modelMeta` object, required
    - `provider` string, required
    - `model` string, required

## Other responses

- `400` — 400
- `502` — 502

---

[API](https://skmtc.net/rxresu/apis/reactive-resume.md) · [All operations](https://skmtc.net/rxresu/apis/reactive-resume/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rxresu/reactive-resume/versions/68d25b21f805/schema)