---
title: "PATCH /jobs/{id}/"
method: PATCH
path: "/jobs/{id}/"
tags: ["jobs"]
---

# PATCH /jobs/{id}/

`PATCH /jobs/{id}/`

## Request

- Base URL: `https://api.manatal.com/open/v3`
- URL: `https://api.manatal.com/open/v3/jobs/{id}/`
- Auth: API key in header `Authorization`

Update partially a job details.

## Request body

- object
  - `id` integer
  - `external_id` string, nullable: Id of the job in the API consumer systems
  - `hash` string: Unique hash of the candidate
  - `organization` integer: Organization the job is assigned to
  - `position_name` string, required: Job title
  - `description` string: Description of the job
  - `headcount` integer, nullable: Number of people to be hired for the job
  - `creator` integer: User who created the job
  - `is_salary_visible` boolean: Whether salary information is displayed to candidates on the career page and job postings.
  - `salary_min` string, decimal, nullable
  - `salary_max` string, decimal, nullable
  - `frequency` string, nullable
  - `currency` string, nullable
  - `industry` integer, nullable
  - `owner` integer, nullable: ID of the owner of the job
  - `address` string: Address of the office the job will take place
  - `city` string: City of the office the job will take place
  - `state` string: State of the office the job will take place
  - `country` string: Country of the office the job will take place
  - `zipcode` string: Code of the city for the address of the office
  - `contract_details` 'full_time' | 'part_time' | 'temporary' | 'freelance' | 'internship' | 'apprenticeship' | 'contractor' | 'consultancy'
  - `is_published` boolean
  - `is_remote` boolean, nullable
  - `status` 'active' | 'on_hold' | 'won' | 'lost': Status of the job
  - `created_at` string, date-time: Date the job was added
  - `updated_at` string, date-time
  - `expected_close_at` string, date-time: Expected date when the job position will be closed/filled
  - `career_page_url` string
  - `custom_fields` object: Job values for custom fields defined in Manatal.
  - `is_pinned_in_career_page` boolean: Whether the job has been added to the career page or not

## Response `200`

- object
  - `id` integer
  - `external_id` string, nullable: Id of the job in the API consumer systems
  - `hash` string: Unique hash of the candidate
  - `organization` integer: Organization the job is assigned to
  - `position_name` string, required: Job title
  - `description` string: Description of the job
  - `headcount` integer, nullable: Number of people to be hired for the job
  - `creator` integer: User who created the job
  - `is_salary_visible` boolean: Whether salary information is displayed to candidates on the career page and job postings.
  - `salary_min` string, decimal, nullable
  - `salary_max` string, decimal, nullable
  - `frequency` string, nullable
  - `currency` string, nullable
  - `owner` integer, nullable: ID of the owner of the job
  - `address` string: Address of the office the job will take place
  - `zipcode` string: Code of the city for the address of the office
  - `contract_details` 'full_time' | 'part_time' | 'temporary' | 'freelance' | 'internship' | 'apprenticeship' | 'contractor' | 'consultancy'
  - `is_published` boolean
  - `is_remote` boolean, nullable
  - `status` 'active' | 'on_hold' | 'won' | 'lost': Status of the job
  - `created_at` string, date-time: Date the job was added
  - `updated_at` string, date-time
  - `career_page_url` string
  - `custom_fields` object: Job values for custom fields defined in Manatal.
  - `is_pinned_in_career_page` boolean: Whether the job has been added to the career page or not
  - `industry` object
    - `id` integer
    - `name` string, required

---

[API](https://skmtc.dev/manatal/apis/manatal-open-api.md) - [All operations](https://skmtc.dev/manatal/apis/manatal-open-api/llms.txt) - [OpenAPI document](https://skmtc.dev/manatal/apis/manatal-open-api/revisions/564633b3d03b?raw)