> ## 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.

# set_job_team

> Replace the job's hiring team with members, in order. Anyone left out is taken off. Everyone must be a member of the company. A signed-in caller must be an owner or admin, since the team decides who reads the job's feedback. Send members: [] to clear it.



## OpenAPI

````yaml /openapi.json put /v1/employer/jobs/{job_id}/team
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/jobs/{job_id}/team:
    put:
      tags:
        - Jobs
      summary: set_job_team
      description: >-
        Replace the job's hiring team with members, in order. Anyone left out is
        taken off. Everyone must be a member of the company. A signed-in caller
        must be an owner or admin, since the team decides who reads the job's
        feedback. Send members: [] to clear it.
      operationId: set_job_team
      parameters:
        - name: job_id
          in: path
          required: true
          description: Job UUID.
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                members:
                  type: array
                  maxItems: 50
                  items:
                    type: object
                    required:
                      - user_id
                    properties:
                      user_id:
                        type: string
                      role:
                        type:
                          - string
                          - 'null'
                        enum:
                          - hiring_manager
                          - recruiter
                          - interviewer
                          - null
            example:
              members:
                - user_id: user_2abc
                  role: hiring_manager
                - user_id: user_7xyz
                  role: interviewer
      responses:
        '200':
          description: The team as saved.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
              example:
                data:
                  - user_id: user_2abc
                    role: hiring_manager
                    name: Alex Park
                    email: alex@acme.com
                    image: null
                  - user_id: user_7xyz
                    role: interviewer
                    name: Maya Chen
                    email: maya@acme.com
                    image: null
        '422':
          description: >-
            Someone isn't a company member, is listed twice, or has an unknown
            role.
      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.