---
title: "Update a job"
method: PUT
path: "/jobs/{id}"
tags: ["Jobs"]
---

# Update a job

`PUT /jobs/{id}`

## Path parameters

- `id` number, required

## Request body

- object
  - `title` string, required
  - `location` object, required — An object containing the location information for the job with the following structure: ``` { "city": "<city>", "state": "<state>", "postal_code": "<postal code>" } ```
    - `city` string
    - `state` string
    - `postal_code` string
  - `country_code` string
  - `company_id` number, required — The ID of the company the job belongs to.
  - `department_id` number — The ID of the department the job belongs to (must be a department linked to the specified company)
  - `recruiter_id` number — The ID of the user who is the recruiter for the job.
  - `owner_id` number — The user id of the record owner
  - `category_name` string
  - `is_hot` boolean
  - `start_date` string
  - `salary` string
  - `max_rate` string
  - `duration` string
  - `type` string
  - `openings` number
  - `external_id` string
  - `description` string
  - `notes` string
  - `contact_id` number — The ID of the contact associated with the job.
  - `custom_fields` unknown[] — An array of custom field objects. Each custom field object should contain two keys: `id` and `value`. `id` is the id of a custom field definition, and `value` is the value to be set to that custom field for this job. ``` [ { "id": <custom field definition id>, "value": "<custom field value>" } ] ```
    - unknown
  - `user_groups` unknown[] — User groups allowed to access this job
    - unknown

## Response `204`

No Content

---

[API](https://skmtc.net/catsone/apis/cats-api-v3.md) · [All operations](https://skmtc.net/catsone/apis/cats-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/catsone/cats-api-v3/versions/dedbbade450d/schema)