# PrepPilot API

Public AI-powered career tools API. No OAuth token is required; production requests must originate from allowed site origins.

## Authentication {#authentication}

PrepPilot APIs are **public** and do not require OAuth access tokens. In production, cross-origin browser requests are restricted to approved site origins.

Discovery metadata is published for agents at:

- API catalog: https://usepreppilot.com/.well-known/api-catalog
- OpenAPI spec: https://usepreppilot.com/.well-known/openapi.json
- Health: https://usepreppilot.com/.well-known/health

## Endpoints

- `POST /api/generate-questions` - Generate interview questions from a job description
- `POST /api/generate-gap-questions` - Generate gap-focused interview questions from fit analysis
- `POST /api/regenerate-question` - Replace one practice question
- `POST /api/get-feedback` - Score and critique an interview answer
- `POST /api/compare-resume` - Compare a resume against a job description
- `POST /api/roast-resume` - Generate a detailed resume roast
- `POST /api/parse-resume` - Extract text from a resume upload
- `POST /api/product-feedback` - Submit optional product feedback
- `POST /api/utility-tools/cover-letter-generator` - Run the cover letter generator utility tool
- `POST /api/utility-tools/linkedin-profile` - Run the linkedin profile utility tool
- `POST /api/utility-tools/thank-you-email` - Run the thank you email utility tool
- `POST /api/utility-tools/salary-negotiation` - Run the salary negotiation utility tool
- `POST /api/utility-tools/application-checklist` - Run the application checklist utility tool
- `POST /api/utility-tools/resume-bullet-rewriter` - Run the resume bullet rewriter utility tool
- `POST /api/utility-tools/introduce-yourself` - Run the introduce yourself utility tool
- `POST /api/utility-tools/cold-outreach` - Run the cold outreach utility tool
- `POST /api/utility-tools/jd-decoder` - Run the jd decoder utility tool
- `POST /api/utility-tools/ats-keywords` - Run the ats keywords utility tool
- `POST /api/utility-tools/star-stories` - Run the star stories utility tool
- `POST /api/utility-tools/interview-question-predictor` - Run the interview question predictor utility tool
- `POST /api/utility-tools/questions-to-ask-interviewer` - Run the questions to ask interviewer utility tool
- `POST /api/utility-tools/gap-answer-coach` - Run the gap answer coach utility tool
- `POST /api/utility-tools/follow-up-question-drill` - Run the follow up question drill utility tool
- `POST /api/utility-tools/recruiter-screen-prep` - Run the recruiter screen prep utility tool
- `POST /api/utility-tools/company-research-brief` - Run the company research brief utility tool
- `POST /api/utility-tools/project-walkthrough` - Run the project walkthrough utility tool
- `POST /api/utility-tools/behavioral-question-bank` - Run the behavioral question bank utility tool
- `POST /api/utility-tools/why-this-role` - Run the why this role utility tool
- `POST /api/utility-tools/compensation-deflector` - Run the compensation deflector utility tool
- `POST /api/utility-tools/interview-day-checklist` - Run the interview day checklist utility tool
- `POST /api/utility-tools/reference-request-email` - Run the reference request email utility tool
- `POST /api/utility-tools/rejection-stay-warm` - Run the rejection stay warm utility tool
- `POST /api/utility-tools/resignation-letter-generator` - Run the resignation letter generator utility tool

## OpenAPI

Machine-readable specification: https://usepreppilot.com/.well-known/openapi.json