---
title: "Update a job"
method: PATCH
path: "/ats/{connection_id}/job/{id}"
tags: ["ats", "job"]
---

# Update a job

`PATCH /ats/{connection_id}/job/{id}`

## Path parameters

- `connection_id` string, required
- `id` string, required

## Query parameters

- `fields` string[]
- `raw` string

## Request body

- AtsJob
  - `id` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `name` string
  - `description` string
  - `recruiter_ids` string[]
  - `hiring_manager_ids` string[]
  - `hiring_managers` AtsReference[]
    - `id` string
    - `name` string
  - `status` 'ARCHIVED' | 'PENDING' | 'DRAFT' | 'OPEN' | 'CLOSED'
  - `closed_at` string, date-time
  - `addresses` AtsAddress[]
    - `address1` string
    - `address2` string
    - `city` string
    - `region` string
    - `region_code` string
    - `postal_code` string
    - `country` string
    - `country_code` string
  - `compensation` AtsCompensation[]
    - `type` 'SALARY' | 'BONUS' | 'STOCK_OPTIONS' | 'EQUITY' | 'OTHER'
    - `min` number
    - `max` number
    - `currency` string
    - `frequency` 'ONE_TIME' | 'DAY' | 'QUARTER' | 'YEAR' | 'HOUR' | 'MONTH' | 'WEEK'
  - `employment_type` 'FULL_TIME' | 'PART_TIME' | 'CONTRACTOR' | 'INTERN' | 'CONSULTANT' | 'VOLUNTEER' | 'CASUAL' | 'SEASONAL' | 'FREELANCE' | 'OTHER'
  - `remote` boolean
  - `language_locale` string
  - `public_job_urls` string[] — URLs for pages containing public listings for the job
  - `number_of_openings` number
  - `company_id` string
  - `questions` AtsJobQuestion[]
    - `id` string
    - `question` string, required
    - `required` boolean
    - `description` string
    - `prompt` string
    - `type` 'TEXT' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'MULTIPLE_CHOICE' | 'FILE' | 'TEXTAREA' | 'MULTIPLE_SELECT' | 'UNIVERSITY' | 'YES_NO' | 'CURRENCY' | 'URL', required
    - `options` string[]
  - `postings` AtsJobPosting[] — Public job postings
    - `id` string
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `posting_url` string
    - `name` string
    - `description` string
    - `address` PropertyAtsJobPostingAddress — job-post-specific address
      - `address1` string
      - `address2` string
      - `city` string
      - `region` string
      - `region_code` string
      - `postal_code` string
      - `country` string
      - `country_code` string
    - `location` string
    - `is_active` boolean
  - `groups` AtsGroup[] — The departments/divisions/teams that this job belongs to
    - `id` string
    - `name` string
    - `type` 'TEAM' | 'GROUP' | 'DEPARTMENT' | 'DIVISION' | 'BUSINESS_UNIT' | 'BRANCH' | 'SUB_DEPARTMENT'
  - `openings` AtsJobOpening[]
    - `status` 'OPEN' | 'CLOSED'
    - `opened_at` string, date-time
    - `closed_at` string, date-time
    - `application_id` string
    - `close_reason` string
  - `minimum_experience_years` number
  - `minimum_degree` string
  - `skills` string[]
  - `metadata` AtsMetadata[]
    - `id` string
    - `slug` string
    - `value` union
      - object
      - string
      - number
      - boolean
      - union[]
        - union
          - object
          - string
          - number
          - boolean
    - `namespace` string
    - `format` 'TEXT' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'FILE' | 'TEXTAREA' | 'SINGLE_SELECT' | 'MULTIPLE_SELECT' | 'MEASUREMENT' | 'PRICE' | 'YES_NO' | 'CURRENCY' | 'URL'
    - `extra_data` union
      - object
      - string
      - number
      - boolean
      - union[]
        - union
          - object
          - string
          - number
          - boolean
  - `user_id` string
  - `raw` object

## Response `200`

Successful

- AtsJob
  - `id` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `name` string
  - `description` string
  - `recruiter_ids` string[]
  - `hiring_manager_ids` string[]
  - `hiring_managers` AtsReference[]
    - `id` string
    - `name` string
  - `status` 'ARCHIVED' | 'PENDING' | 'DRAFT' | 'OPEN' | 'CLOSED'
  - `closed_at` string, date-time
  - `addresses` AtsAddress[]
    - `address1` string
    - `address2` string
    - `city` string
    - `region` string
    - `region_code` string
    - `postal_code` string
    - `country` string
    - `country_code` string
  - `compensation` AtsCompensation[]
    - `type` 'SALARY' | 'BONUS' | 'STOCK_OPTIONS' | 'EQUITY' | 'OTHER'
    - `min` number
    - `max` number
    - `currency` string
    - `frequency` 'ONE_TIME' | 'DAY' | 'QUARTER' | 'YEAR' | 'HOUR' | 'MONTH' | 'WEEK'
  - `employment_type` 'FULL_TIME' | 'PART_TIME' | 'CONTRACTOR' | 'INTERN' | 'CONSULTANT' | 'VOLUNTEER' | 'CASUAL' | 'SEASONAL' | 'FREELANCE' | 'OTHER'
  - `remote` boolean
  - `language_locale` string
  - `public_job_urls` string[] — URLs for pages containing public listings for the job
  - `number_of_openings` number
  - `company_id` string
  - `questions` AtsJobQuestion[]
    - `id` string
    - `question` string, required
    - `required` boolean
    - `description` string
    - `prompt` string
    - `type` 'TEXT' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'MULTIPLE_CHOICE' | 'FILE' | 'TEXTAREA' | 'MULTIPLE_SELECT' | 'UNIVERSITY' | 'YES_NO' | 'CURRENCY' | 'URL', required
    - `options` string[]
  - `postings` AtsJobPosting[] — Public job postings
    - `id` string
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `posting_url` string
    - `name` string
    - `description` string
    - `address` PropertyAtsJobPostingAddress — job-post-specific address
      - `address1` string
      - `address2` string
      - `city` string
      - `region` string
      - `region_code` string
      - `postal_code` string
      - `country` string
      - `country_code` string
    - `location` string
    - `is_active` boolean
  - `groups` AtsGroup[] — The departments/divisions/teams that this job belongs to
    - `id` string
    - `name` string
    - `type` 'TEAM' | 'GROUP' | 'DEPARTMENT' | 'DIVISION' | 'BUSINESS_UNIT' | 'BRANCH' | 'SUB_DEPARTMENT'
  - `openings` AtsJobOpening[]
    - `status` 'OPEN' | 'CLOSED'
    - `opened_at` string, date-time
    - `closed_at` string, date-time
    - `application_id` string
    - `close_reason` string
  - `minimum_experience_years` number
  - `minimum_degree` string
  - `skills` string[]
  - `metadata` AtsMetadata[]
    - `id` string
    - `slug` string
    - `value` union
      - object
      - string
      - number
      - boolean
      - union[]
        - union
          - object
          - string
          - number
          - boolean
    - `namespace` string
    - `format` 'TEXT' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'FILE' | 'TEXTAREA' | 'SINGLE_SELECT' | 'MULTIPLE_SELECT' | 'MEASUREMENT' | 'PRICE' | 'YES_NO' | 'CURRENCY' | 'URL'
    - `extra_data` union
      - object
      - string
      - number
      - boolean
      - union[]
        - union
          - object
          - string
          - number
          - boolean
  - `user_id` string
  - `raw` object

---

[API](https://skmtc.net/unified/apis/unified-to-api.md) · [All operations](https://skmtc.net/unified/apis/unified-to-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unified/unified-to-api/versions/1f72720916e4/schema)