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

# Update Job Type

> Updates the job type referenced by the provided job type ID.



## OpenAPI

````yaml PATCH /job-types/{JOB_TYPE_ID}
openapi: 3.0.1
info:
  title: Alpharun API
  description: Alpharun REST API reference
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.alpharun.com/api/v1
security:
  - bearerAuth: []
paths:
  /job-types/{JOB_TYPE_ID}:
    patch:
      summary: Update a job type
      description: Updates the job type referenced by the provided job type ID.
      parameters:
        - name: JOB_TYPE_ID
          in: path
          description: The ID of the job type to update.
          required: true
          schema:
            type: string
            format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateJobTypePayload'
            example:
              name: Store Manager
              job_description: <job_description>
              ai_interviewer_guidance: Be friendly and professional
              resume_collection_type: before_interview
              should_force_fullscreen: true
              should_record_video: true
      responses:
        '200':
          description: Job type updated successfully
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                properties:
                  data:
                    $ref: '#/components/schemas/JobTypeResponse'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Unauthorized - Invalid or missing API key
        '404':
          description: Job type not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: Conflict - The provided name is already used by another job type
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal server error
components:
  schemas:
    UpdateJobTypePayload:
      type: object
      description: >-
        Job type fields to update. Only the fields included in the request are
        updated.
      properties:
        name:
          type: string
          minLength: 3
          maxLength: 150
          description: >-
            Name of the job type. Must be unique across the company's other job
            types.
        job_description:
          type: string
          minLength: 20
          maxLength: 15000
          description: Detailed description of the job
        ai_interviewer_guidance:
          type: string
          nullable: true
          minLength: 15
          maxLength: 3000
          description: Guidance for the AI interviewer. Set to `null` to clear it.
        resume_collection_type:
          type: string
          nullable: true
          enum:
            - after_interview
            - before_interview
          description: >-
            Resume collection configuration. Set to `null` to disable resume
            collection.
        should_force_fullscreen:
          type: boolean
          description: Whether to force fullscreen mode
        should_record_video:
          type: boolean
          description: Whether to record video
    JobTypeResponse:
      type: object
      required:
        - job_type
      properties:
        job_type:
          $ref: '#/components/schemas/JobType'
    Error:
      required:
        - error
        - message
      type: object
      properties:
        error:
          type: integer
          format: int32
        message:
          type: string
    JobType:
      type: object
      required:
        - id
        - name
        - job_description
        - ai_interviewer_guidance
        - qualifications
        - resume_collection_type
        - should_force_fullscreen
        - should_record_video
      properties:
        id:
          type: string
          format: uuid
          description: The ID of the job type.
        name:
          type: string
          description: The name of the job type.
        job_description:
          type: string
          description: The job description used by the AI interviewer.
        ai_interviewer_guidance:
          type: string
          nullable: true
          description: Additional guidance for the AI interviewer.
        qualifications:
          type: array
          items:
            type: string
          description: Assessment qualifications configured for this job type.
        resume_collection_type:
          type: string
          nullable: true
          enum:
            - after_interview
            - before_interview
          description: When candidates are prompted to provide a resume.
        should_force_fullscreen:
          type: boolean
          description: Whether the interview experience requires fullscreen mode.
        should_record_video:
          type: boolean
          description: Whether interviews for this job type record video.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````