Coding agent documentation index Fetch the complete documentation index at: https://docs.worklittle.com/docs-agent-manifest.json Use this file to discover all available pages before exploring further.

Create resumes

Generate a one-page hiring-ready resume (HTML, PDF, and/or DOCX) tailored to a job.

Overview

POST /jobs/resumes (MCP create_resume) builds a one-page résumé from optional resume_text, profile, and a target job_id. Hiring-ready output has no placeholders - unknowns are omitted, not invented. Requires agent:tools. Metered AI usage - Pricing. For cover letters see Create cover letters.

When to use

If you are building:

A résumé tailor for a specific posting Pass job_id (or job_context from get_job_keywords) so bullets emphasize that role An apply pipeline that uploads a PDF Use default html+pdf, then send pdf_base64 as resume_file on Apply for jobs A profile-to-document product Feed structured profile plus existing resume_text and let the API layout one Letter page

Basic usage

curl -s -X POST "https://api.worklittle.com/jobs/resumes" \
  -H "Authorization: Bearer $WORKLITTLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "job_id": "YOUR_JOB_ID",
    "resume_text": "10 years frontend, React, design systems",
    "instructions": "Emphasize platform engineering"
  }'

MCP create_resume uses the same JSON body. Omit formats for default html + pdf.

> Tip: Prefer get_job_keywords in job_context over pasting a full job description into instructions.

Output formats

This page is the canonical reference for document formats / Accept (cover letters use the same rules).

| Request | Outputs |
| --- | --- |
| omit `formats` / `format` / document `Accept` | **html + pdf** |
| `formats: ["html"]` or `format: "html"` or `Accept: text/html` | html only |
| `format: "pdf"` or `Accept: application/pdf` | html + pdf |
| `format: "docx"` or Word MIME `Accept` | html + docx |
| `formats: ["html","pdf","docx"]` | all three (one AI charge) |

Precedence: body formats > body format > Accept > default. Invalid body > 400. Accept with only unknown types > 406. Response is always a JSON envelope (not raw PDF bytes).

PDF is US Letter, one page, shrink-to-fit (same pipeline as Worklittle consumer). DOCX is the same HTML with tight margins (no font auto-fit). Conversion is free - you only pay AI tokens.

Create resumes reference

> Résumé endpoints only.

Overview

| Method | Path | Purpose |
| --- | --- | --- |
| POST | `/jobs/resumes` | Hiring-ready one-page resume (default html + pdf; optional docx) |

Requires agent:tools. Metered AI tokens only - Pricing. MCP: create_resume. Cover letters: Create cover letters.

Legacy: POST /v1/agent/tool with { "name": "create_resume", "args": { … } }.

Request body

| Field | Type | Notes |
| --- | --- | --- |
| `job_id` | string | Target role; server loads posting context when set |
| `resume_text` | string | Existing résumé plain text (primary content source) |
| `profile` | object | Structured candidate fields (name, experience, education, …) |
| `job_context` | object | Pre-fetched job fields / keywords |
| `instructions` | string | Emphasis hints (e.g. highlight systems work) - not a paste of the full JD |
| `formats` | string[] | Subset of `html`, `pdf`, `docx` |
| `format` | string | Alias: `html` \| `pdf` \| `docx` |

All fields optional. Hiring-ready mode omits unknown lines - it does not invent employers or leave placeholders.

Response

{
  "document_type": "resume",
  "mode": "ready",
  "formats": ["html", "pdf"],
  "html": "<h1>…</h1>…",
  "pdf_base64": "JVBERi0xLjQK…",
  "pdf_mime": "application/pdf",
  "pdf_filename": "resume.pdf",
  "docx_base64": null,
  "docx_mime": null,
  "docx_filename": null,
  "billing": { }
}

Attach pdf_base64 on apply via resume_file, or render html in your own editor.

Common mistakes

| Wrong | Correct |
| --- | --- |
| Inventing employers or dates when the profile is thin | Omit unknowns. Do not invent history |
| Dumping the full JD into `instructions` | Use `get_job_keywords` > `job_context` |
| Attaching the cover letter PDF as `resume_file` | Use `resume_file` for the résumé; cover letter fields are separate |
| Missing `agent:tools` | Add the scope on the API key |

Patterns and gotchas

One page - PDF auto-shrinks to fit Letter; keep content concise. Facts only - hiring-ready never invents employers, schools, or metrics. Apply - resume_file.content_base64 on submit_job_application. Sibling API - narrative letters are on Create cover letters.