> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hotfix.jobs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Product noun is jobs.
> MCP at https://rest.hotfix.jobs/mcp is the hiring contract for agents. Clients sign in with Hotfix; API keys are for HTTP only.
> Do not invent unpublished REST or hiring stats. Webhooks are set up in the app; there is no REST route or MCP tool to manage them.
> Do not mention Greenhouse, Ashby, Quick Apply, or claim.
> Creating a draft, offer, or booking link does not send email.

# list_fields

> Your company's custom fields, in order: id, key, name, type (text, number, currency, date, boolean, single_select, multi_select, or member), the currency of a currency field, select options, and whether candidates can answer it on apply forms. Use the key with set_custom_field and the field filter. MCP tool: list_fields.



## OpenAPI

````yaml /openapi.json get /v1/employer/fields
openapi: 3.1.0
info:
  title: Hotfix hiring API
  version: 1.0.0
  description: >-
    Employer hiring surface under /v1/employer, plus the public careers page
    reads under /v1/boards. Routes take an employer session Bearer token. Hiring
    data routes also accept a company API key (hf_…); mail and drafts are
    session only. Agents should prefer MCP at https://rest.hotfix.jobs/mcp,
    where they sign in with Hotfix. It is not a dump of
    rest.hotfix.jobs/openapi.json.
servers:
  - url: https://rest.hotfix.jobs
    description: Production
security: []
tags:
  - name: Applications
  - name: Jobs
  - name: Careers page
  - name: Interviews
  - name: Offers
  - name: Mail
  - name: Automations
  - name: Fields
paths:
  /v1/employer/fields:
    get:
      tags:
        - Fields
      summary: list_fields
      description: >-
        Your company's custom fields, in order: id, key, name, type (text,
        number, currency, date, boolean, single_select, multi_select, or
        member), the currency of a currency field, select options, and whether
        candidates can answer it on apply forms. Use the key with
        set_custom_field and the field filter. MCP tool: list_fields.
      operationId: list_fields
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
              example:
                data:
                  - id: 8b0f6f7e-1c2d-4e3f-9a8b-7c6d5e4f3a21
                    key: salary_expectation
                    name: Salary expectation
                    type: currency
                    options: []
                    ask_candidates: true
                    help_text: null
                    icon: currency-dollar
                    token_in: []
                    currency: USD
                cap: 50
      security:
        - ApiKey: []
        - BearerAuth: []
components:
  securitySchemes:
    ApiKey:
      type: http
      scheme: bearer
      description: >-
        Company API key minted at Settings → API. Prefix hf_. Accepted on hiring
        data routes. Not accepted on MCP.
    BearerAuth:
      type: http
      scheme: bearer
      description: Employer session JWT from Better Auth.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.