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

> Updates an existing job opening and its associated job type



## OpenAPI

````yaml PATCH /job-openings/{JOB_OPENING_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-openings/{JOB_OPENING_ID}:
    patch:
      summary: Update a job opening
      description: Updates an existing job opening and its associated job type
      parameters:
        - name: JOB_OPENING_ID
          in: path
          description: The ID of the job opening to update
          required: true
          schema:
            type: string
            format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateJobOpeningPayload'
            example:
              name: Store Manager - San Francisco
              location: In-office 3 days per week in San Francisco, CA
              pay: $18 per hour or $80,000 - $100,000 per year
              hours: Full-time, 40 hours per week
              status: live
              link_access:
                restricted: false
              owner_emails:
                - amy@acme.com
              job_type:
                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 opening updated successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/JobOpeningResponse'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Job opening not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal server error
components:
  schemas:
    UpdateJobOpeningPayload:
      type: object
      properties:
        name:
          type: string
          minLength: 3
          maxLength: 150
          description: Name of the job opening
        location:
          type: string
          nullable: true
          maxLength: 200
          description: Location of the job
        pay:
          type: string
          nullable: true
          maxLength: 200
          description: Pay information
        hours:
          type: string
          nullable: true
          maxLength: 200
          description: Working hours information
        status:
          type: string
          enum:
            - live
            - paused
          description: Status of the job opening
        link_access:
          type: object
          properties:
            restricted:
              type: boolean
              description: >-
                Whether the link to the interview is restricted to
                pre-registered candidates only
        job_type:
          type: object
          properties:
            name:
              type: string
              minLength: 3
              maxLength: 150
              description: Name of the job type
            job_description:
              type: string
              minLength: 20
              maxLength: 10000
              description: Detailed description of the job
            ai_interviewer_guidance:
              type: string
              nullable: true
              minLength: 15
              maxLength: 3000
              description: Guidance for the AI interviewer
            resume_collection_type:
              type: string
              nullable: true
              enum:
                - after_interview
                - before_interview
              description: Resume collection configuration
            should_force_fullscreen:
              type: boolean
              description: Whether to force fullscreen mode
            should_record_video:
              type: boolean
              description: Whether to record video
        owner_emails:
          type: array
          items:
            type: string
            format: email
          description: Array of email addresses for job opening owners
    JobOpeningResponse:
      type: object
      properties:
        job_opening:
          type: object
          properties:
            id:
              type: string
              description: The ID of the job opening
            name:
              type: string
              description: The name of the job opening
            status:
              type: string
              enum:
                - live
                - paused
              description: The status of the job opening
            interview_link:
              type: string
              description: The link to the interview for this job opening
            link_access:
              type: object
              properties:
                restricted:
                  type: boolean
                  description: >-
                    Whether the link to the interview is restricted to
                    pre-registered candidates only
            location:
              type: object
              properties:
                description:
                  type: string
                  description: The location of the job opening
            pay:
              type: object
              properties:
                description:
                  type: string
                  description: The pay of the job opening
            hours:
              type: object
              properties:
                description:
                  type: string
                  description: The hours of the job opening
            questions:
              type: array
              items:
                type: string
              description: The questions of the job opening
            owner_emails:
              type: array
              items:
                type: string
                format: email
              description: Array of teammate email addresses for job opening owners.
            job_type:
              type: object
              properties:
                id:
                  type: string
                  description: The ID of the job opening
                name:
                  type: string
                  description: The name of the job type
                job_description:
                  type: string
                  description: The job description of the job type
                ai_interviewer_guidance:
                  type: string
                  description: The AI interviewer guidance of the job type
                qualifications:
                  type: array
                  items:
                    type: string
                  description: The qualifications of the job type
                resume_collection_type:
                  type: string
                  enum:
                    - after_interview
                    - before_interview
                  description: The resume collection type of the job type
                should_force_fullscreen:
                  type: boolean
                  description: Whether to force fullscreen mode
                should_record_video:
                  type: boolean
                  description: Whether to record video
    Error:
      required:
        - error
        - message
      type: object
      properties:
        error:
          type: integer
          format: int32
        message:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````