Changelog

This page tracks every shipping change to the JobTactics Public API. Entries are dated and grouped by category. Breaking changes are called out explicitly.

v1.0.1 — 2026-05-18

Removed — Matching (breaking)

• POST /public/matching/quick and POST /public/matching/quick/batch have been removed from the public API. Quick match is an internal SaaS feature (provisional profile-vs-offer scoring that powers the dashboard and the jobs page) and is not relevant to third-party API consumers. The keywords/scan endpoint — never actually implemented and documented by mistake — is also gone (keyword coverage is provided by POST /public/ats/audit).

Fixed

• POST /public/cv/generate, POST /public/ats/audit, POST /public/cover-letter/generate and POST /public/resignation-letter/generate returned 500 because the operation_costs.api_endpoint mapping was never populated in production. The mapping is now backfilled and seeded — these endpoints work as documented.

v1.0.0 — 2026-05-04

The first public release of the API expands the surface from four endpoints to a complete integration toolkit (31 endpoints), all gated by personal API keys generated in Settings → API keys.

Added — AI generation

• POST /public/bullet-points/generate — generate ATS-aware bullet points for a job experience.
• POST /public/experience-description/generate — produce a polished narrative description.
• POST /public/professional-summary/generate — craft a 3-5 sentence positioning summary.
• POST /public/reformulator/reformulate — rewrite text with the requested tone.
• POST /public/skills-generation/generate — generate 20 mixed (hard + soft) skills from a title.
• POST /public/linkedin-optimizer/generate — optimized LinkedIn profile content.

Added — Application scoring

• GET /public/application-score/profile/{profileId} — readiness signal for a profile.
• GET /public/application-score/application/{applicationId} — fit score for one application.
• POST /public/application-score/applications/batch — batch-score a list of applications.

Added — Profile, document and folder CRUD

• Full CRUD on /public/profiles (list, get, create, update, delete, set default).
• Full CRUD on /public/documents for every document type (cv, cover_letter, resignation_letter, linkedin_profile, cv_audit, cv_optimization, job_analysis), filterable by ?type=.
• Full CRUD on /public/documents/folders.

Added — Document exports

• POST /public/documents/{id}/export-pdf — CV to PDF.
• POST /public/documents/{id}/export-letter-pdf — letter (cover or resignation) to PDF.
• POST /public/documents/{id}/export-letter-docx — letter to DOCX.
• POST /public/documents/{id}/export-report-pdf — audit / optimization / analysis report PDF.

All export endpoints follow the same async pattern: the file is generated, uploaded to private storage and returned as a presigned URL valid for one hour, in this exact JSON shape:

{
  "downloadUrl": "https://...",
  "expiresAt": "2026-05-04T18:30:00.000Z",
  "filename": "cv-jane-doe-software-engineer-acme-04-05-2026.pdf",
  "contentType": "application/pdf",
  "sizeBytes": 245678
}

Added — Read-only resources

• GET /public/credits/balance — current credit balance.
• GET /public/credits/history — paginated transaction history.
• GET /public/templates — list templates the caller owns (free + purchased).
• GET /public/templates/{id} — retrieve a single owned template.

Added — Settings

• PATCH /public/settings/language — change the preferred generation language.

Notes

• The earlier /public/cv/generate, /public/ats/audit, /public/cover-letter/generate and /public/resignation-letter/generate endpoints are unchanged — existing integrations keep working.
• The interactive reference is now a separately versioned site (this docs.jobtactics.io domain), served independently from the API.