Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/CristianParadaLopez/cv-builder/llms.txt

Use this file to discover all available pages before exploring further.

Submit raw or informal text for a specific CV field and receive a professionally worded version suitable for a resume. The AI rewrites the input in professional Spanish using action verbs, concise phrasing, and the conventions appropriate for the requested section type.

​
Request

Method: POST
Path: /api/cv/suggest
Content-Type: application/json
​
userText
string
required
The raw or informal text to improve. Must be a non-empty string and cannot exceed 600 characters. This is the text the candidate typed — it can be conversational, grammatically rough, or simply underdeveloped.
​
context
string
required
The CV section the text belongs to. Must be one of the valid context values listed below. The context tells the AI which writing conventions to apply (action verbs for experience, keyword-dense phrases for skills, and so on).Valid values: "experience", "summary", "education", "skills", "tools", "project", "certification", "volunteer"
​
systemPrompt
string
An optional additional instruction injected at the beginning of the AI prompt. Use this to supply extra context, preferred tone, target industry, or other constraints. Omit or pass an empty string to use the default behavior.
​
examples
string[]
An optional array of example output strings to guide the AI’s style and length. Each element should be a sample of the kind of professional text you want the model to produce.

​
Validation

  • userText must be present and a non-empty string. Returns 400 otherwise.
  • context must be present and a non-empty string. Returns 400 otherwise.
  • context must match one of the eight valid values exactly. Returns 400 with "Contexto inválido" for unrecognized values.
  • userText must not exceed 600 characters. Returns 400 if exceeded.

​
Response

Status: 200 OK
​
suggestion
string
The professionally rewritten version of the input text. The response is plain text with no markdown formatting, no code fences, and no explanatory preface. For experience sections, verbs appear in the past tense. The output is typically limited to four lines or four bullet items depending on the context.

​
Error responses

StatusCondition
400userText is missing or empty
400context is missing or empty
400context is not one of the eight valid values
400userText exceeds 600 characters
500AI model returned an error or all fallback models failed

​
Example request

curl -X POST http://localhost:3001/api/cv/suggest \
  -H 'Content-Type: application/json' \
  -d '{
    "userText": "trabajé en el área de ventas atendiendo clientes",
    "context": "experience"
  }'

​
Example response

{
  "suggestion": "Gestioné atención al cliente en el área comercial, cumpliendo metas de ventas mensuales y mejorando indicadores de satisfacción."
}

​
Context guide

Each context value produces a different writing style:
ContextWhat the AI produces
experienceBullet-style action statements in past tense describing responsibilities and achievements
summaryA concise two-to-three sentence professional profile paragraph
educationFormal academic phrasing with degree, institution, and optional distinction
skillsComma-separated or listed professional skill keywords
toolsTechnical tool names formatted for a CV tools section
projectA brief project description highlighting scope, technologies, and outcomes
certificationFormal certification name and issuing body phrasing
volunteerVolunteer role description with impact-focused language
Use the systemPrompt field to specify the candidate’s industry or target role. For example: "El candidato aplica a posiciones de ingeniería de software en empresas tecnológicas medianas." This steers the AI toward more relevant vocabulary and phrasing.

Build docs developers (and LLMs) love

Get started for freeTalk to us