# Hotfix Jobs

> Hiring HTTP under /v1/employer, plus MCP for company API keys. Same jobs on the board and in the inbox.

> ## Agent Instructions
> Product noun is jobs.
> MCP at https://rest.hotfix.jobs/mcp is the hiring contract for agents with a company API key.
> Do not invent unpublished REST, hiring stats, or webhooks.
> Do not mention Greenhouse, Ashby, Quick Apply, or claim.
> Creating a draft, offer, or booking link does not send email.

- [Introduction](https://docs.hotfix.jobs/index.md): Hiring HTTP under /v1/employer, plus MCP for company API keys. Same jobs on the board and in the inbox.
- [Authentication](https://docs.hotfix.jobs/authentication.md): Send Authorization: Bearer hf_… on every agent request. Mint the key at Org → API.
- [Jobs](https://docs.hotfix.jobs/jobs.md): Board post is not Hotfix search. Extract, then set_job_listed. close_job is terminal.
- [Applications](https://docs.hotfix.jobs/applications.md): Statuses, hidden knockouts, archive is not a status. Notes and set_status do not email.
- [Interviews](https://docs.hotfix.jobs/interviews.md): One open booking link. get_availability is MCP only. Creating the link does not send.
- [Offers and mail](https://docs.hotfix.jobs/offers-and-mail.md): create_offer and create_draft do not send. Accept and Decline are magic links, not tools.
- [Automations](https://docs.hotfix.jobs/automations.md): Fixed WHEN, IF, THEN. One default action branch. Starts paused. Never sends email.
- [Changelog](https://docs.hotfix.jobs/changelog.md): Hiring API, dashboard, and MCP updates.
- [Overview](https://docs.hotfix.jobs/hiring-mcp/index.md): Hotfix MCP is the hiring contract for agents. Company API key, Streamable HTTP, same jobs as the board and inbox.
- [Get started](https://docs.hotfix.jobs/hiring-mcp/get-started.md): Connect Cursor, Claude Code, or another MCP client to rest.hotfix.jobs/mcp.
- [Supported tools](https://docs.hotfix.jobs/hiring-mcp/tools.md): Every MCP tool you can call today. Most map to an HTTP route under /v1/employer.
- [list_applications](https://docs.hotfix.jobs/reference/list-applications.md): List hosted applications for this company. Knockout failures stay hidden by default. status defaults to new. MCP tool: list_applications.
- [get_application](https://docs.hotfix.jobs/reference/get-application.md): One hosted application, including answers. Send Accept: text/markdown for the markdown form. MCP tool: get_application. GET the resume path with a session or an API key. See resume. Accept: text/markdown returns the same document as get_application_markdown on MCP.
- [set_status](https://docs.hotfix.jobs/reference/set-status.md): Move one application, or archive it. Does not send email. MCP tool: set_status.
- [add_note](https://docs.hotfix.jobs/reference/add-note.md): Add a markdown note on one application. Attributed to the caller. Does not send email. MCP tool: add_note.
- [resume](https://docs.hotfix.jobs/reference/resume.md): Download the PDF for one application. This is the only hiring REST path that also accepts an API key.
- [list_jobs](https://docs.hotfix.jobs/reference/list-jobs.md): Active jobs for this company. on_board means the careers page. listed_on_hotfix means Hotfix search. MCP tool: list_jobs.
- [get_form_schema](https://docs.hotfix.jobs/reference/get-form-schema.md): The seeker apply form for one hosted job. Same FormField list as board and catalog Quick apply. On HTTP, read form_schema on the job detail response. MCP tool: get_form_schema.
- [create_job](https://docs.hotfix.jobs/reference/create-job.md): Post a job on the company board. It is not on Hotfix search until extract is confirmed, then call set_job_listed. MCP tool: create_job. Publish spends a live-job slot. The job stays off Hotfix search until extract confirms it is tech, then POST list.
- [update_job](https://docs.hotfix.jobs/reference/update-job.md): Edit an active job. title and description are required on this route. Does not close the job. MCP tool: update_job. Changing the title, description, locations, countries, category, work type, employment, or salary takes the job off Hotfix search until extract is confirmed. Department edits do not re…
- [set_job_listed](https://docs.hotfix.jobs/reference/set-job-listed.md): List or unlist one job on Hotfix search. Does not close the job. Listing requires a confirmed extract. MCP tool: set_job_listed.
- [close_job](https://docs.hotfix.jobs/reference/close-job.md): Close one job. This is terminal. It leaves the careers page and Hotfix search. There is no reopen. MCP tool: close_job. The same role later is a new job. Applications stay on the closed job.
- [list_interviews](https://docs.hotfix.jobs/reference/list-interviews.md): Pending link, upcoming interviews, and past interviews on one application. Includes hosts who can be booked. MCP tool: list_interviews.
- [create_self_schedule_link](https://docs.hotfix.jobs/reference/create-self-schedule-link.md): Open a self-schedule link for one application. The candidate picks the time. Does not email the applicant. MCP tool: create_self_schedule_link. One pending booking link at a time. Put the booking URL in a letter yourself. A person still hits Send.
- [cancel_interview](https://docs.hotfix.jobs/reference/cancel-interview.md): Cancel one interview. A booked meeting is removed from the calendar. Does not reject the applicant and does not send email. MCP tool: cancel_interview.
- [reschedule_interview](https://docs.hotfix.jobs/reference/reschedule-interview.md): Cancel a booked interview and open a new self-schedule link. Does not email the applicant. MCP tool: reschedule_interview.
- [get_offer](https://docs.hotfix.jobs/reference/get-offer.md): The latest offer on one application. offer_url is set only while it is pending. Does not email anyone. MCP tool: get_offer. When there is no offer, offer is null.
- [create_offer](https://docs.hotfix.jobs/reference/create-offer.md): Create a pending offer and its magic link. Pay and start date are required. Does not email the applicant. MCP tool: create_offer. One active letter at a time. Accept moves them to Hired. Decline leaves them Interviewing. Not e-sign. A person still hits Send.
- [rescind_offer](https://docs.hotfix.jobs/reference/rescind-offer.md): Rescind an open offer. Does not email the applicant. MCP tool: rescind_offer. Rescind only while the offer is pending. After Accept they are Hired. Rescind does not un-hire.
- [create_draft](https://docs.hotfix.jobs/reference/create-draft.md): Save the open letter on one application. Does not send. A person still hits Send. MCP tool: create_draft. This replaces the one open draft. MCP can also start from a template_id. Tokens render when a person sends.
- [list_automations](https://docs.hotfix.jobs/reference/list-automations.md): List Fixed hiring automations for this company. status is active, paused, or archived. job_id limits to one job. MCP tool: list_automations.
- [create_automation](https://docs.hotfix.jobs/reference/create-automation.md): Create a Fixed hiring automation (WHEN, IF, THEN). Defaults to paused. branches must include default with the action list. Actions never send email, create offers, or book meetings. A person still hits Send for drafts. MCP tool: create_automation.
- [seed_automation_pack](https://docs.hotfix.jobs/reference/seed-automation-pack.md): Install the starting automation pack for this company, paused. Safe to call again. If the pack is already installed, returns the current list. Does not send email. MCP tool: seed_automation_pack.
- [get_automation](https://docs.hotfix.jobs/reference/get-automation.md): One Fixed hiring automation for this company, including trigger, conditions, and branches.default. MCP tool: get_automation.
- [update_automation](https://docs.hotfix.jobs/reference/update-automation.md): Patch one Fixed hiring automation. Only set fields change. Pass clear_job true to drop the job scope. Does not send email. MCP tool: update_automation.
- [archive_automation](https://docs.hotfix.jobs/reference/archive-automation.md): Archive one hiring automation. Run history stays. Does not send email. MCP tool: archive_automation.
- [run_automation](https://docs.hotfix.jobs/reference/run-automation.md): Run one hiring automation now. Pass application_id when the flow needs an application snapshot. Does not send email. MCP tool: run_automation.
- [list_automation_runs](https://docs.hotfix.jobs/reference/list-automation-runs.md): List recent runs for one hiring automation. status filters skipped, failed, or ran. MCP tool: list_automation_runs.

## OpenAPI Specs

- [openapi](/openapi.json)