--- title: "Update a job" url: "https://docs.unified.to/ats/job/Update_a_job" description: "API reference for Update a job. Launch multiple pre-built Job integrations today with zero maintenance — all through a single API." generated_at: "2026-05-21T18:13:32.376Z" --- # Update a job PUT/ats/{connection\_id}/job/{id} ## Parameters **fields**string array id created\_at updated\_at name description recruiter\_ids hiring\_manager\_ids hiring\_managers status closed\_at addresses compensation employment\_type remote language\_locale public\_job\_urls number\_of\_openings company\_id questions postings groups openings minimum\_experience\_years minimum\_degree skills metadata user\_id raw Fields to return **raw**string Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar **connection\_id**string required ID of the connection **id**string required ID of the Job ## Payload **id**string **created\_at**date (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) **updated\_at**date (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) **name**string **description**string **recruiter\_ids**string array **hiring\_manager\_ids**string array **hiring\_managers** array **status** enum Valid values: "ARCHIVED" "PENDING" "DRAFT" "OPEN" "CLOSED" **closed\_at**date (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) **addresses** array **compensation** array **employment\_type** enum Valid values: "FULL\_TIME" "PART\_TIME" "CONTRACTOR" "INTERN" "CONSULTANT" **remote**boolean **language\_locale**string Preferred language for the job, in ISO 639-1 format (e.g., U.S. English is en-us) **public\_job\_urls**string array URLs for pages containing public listings for the job **number\_of\_openings**number Number of openings for the job **company\_id**string id value of the company associated with the job in the ATS (reference to AtsCompany) **questions** array **postings** array Public job postings **groups** array The departments/divisions/teams that this job belongs to **openings** array **minimum\_experience\_years**number **minimum\_degree**string **skills**string array **metadata** array **user\_id**string User id of the job owner in the ATS (references an HRIS employee) (reference to HrisEmployee) **raw**any ## Returns [AtsJob](/ats/job/model) **id**string **created\_at**date (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) **updated\_at**date (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) **name**string **description**string **recruiter\_ids**string array **hiring\_manager\_ids**string array **hiring\_managers** array **status** enum Valid values: "ARCHIVED" "PENDING" "DRAFT" "OPEN" "CLOSED" **closed\_at**date (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) **addresses** array **compensation** array **employment\_type** enum Valid values: "FULL\_TIME" "PART\_TIME" "CONTRACTOR" "INTERN" "CONSULTANT" **remote**boolean **language\_locale**string Preferred language for the job, in ISO 639-1 format (e.g., U.S. English is en-us) **public\_job\_urls**string array URLs for pages containing public listings for the job **number\_of\_openings**number Number of openings for the job **company\_id**string id value of the company associated with the job in the ATS (reference to AtsCompany) **questions** array **postings** array Public job postings **groups** array The departments/divisions/teams that this job belongs to **openings** array **minimum\_experience\_years**number **minimum\_degree**string **skills**string array **metadata** array **user\_id**string User id of the job owner in the ATS (references an HRIS employee) (reference to HrisEmployee) **raw**any ## Code Samples ### Node.js SDK ``` import { UnifiedTo } from '@unified-api/typescript-sdk'; const sdk = new UnifiedTo({ security: { jwt: '', }, }); const connectionId = '5de520f96e439b002043d8dc'; const id = '1234'; const results = await sdk.ats.updateAtsJob({ connectionId, id, atsJob: { }, fields: '', raw: '', }); ``` ### Node.js (axios) ``` const options = { method: 'PUT', url: 'https://api.unified.to/ats/5de520f96e439b002043d8dc/job/5de520f96e439b002043d8d8', headers: { authorization: 'bearer .....' }, data: undefined, params: { fields: '', raw: '', } }; const results = await axios.request(options); ``` ### Java ``` AsyncHttpClient client = new DefaultAsyncHttpClient(); client.prepare("PUT", "https://api.unified.to/ats/5de520f96e439b002043d8dc/job/5de520f96e439b002043d8d8?fields=&raw=") .setHeader("accept", "application/json") .setHeader("authorization", ".....") .execute() .toCompletableFuture() .thenAccept(System.out::println) .join(); client.close(); ``` ### Go ``` import ( "fmt" "net/http" "io/ioutil" ) url := `https://api.unified.to/ats/5de520f96e439b002043d8dc/job/5de520f96e439b002043d8d8?fields=&raw= req, _ := http.NewRequest("PUT", url, nil) req.Header.Add("accept", "application/json") req.Header.Add("authorization", ".....") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := ioutil.ReadAll(res.Body) ``` ### Python ``` import requests url = "https://api.unified.to/ats/5de520f96e439b002043d8dc/job/5de520f96e439b002043d8d8?fields=&raw=" headers = { "accept": "application/json", "authorization": "....." } response = requests.put(url, headers=headers) ``` ### PHP ``` $curl = curl_init(); curl_setopt_array($curl, [ CURLOPT_URL => "https://api.unified.to/ats/5de520f96e439b002043d8dc/job/5de520f96e439b002043d8d8?fields=&raw=", CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => "", CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 30, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => "PUT", CURLOPT_HTTPHEADER => [ "accept: application/json", "authorization: ....." ], ]); ``` ### Ruby ``` require 'uri' require 'net/http' require 'openssl' url = URI("https://api.unified.to/ats/5de520f96e439b002043d8dc/job/5de520f96e439b002043d8d8?fields=&raw=") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Put.new(url) request["accept"] = 'application/json' request["authorization"] = '....' response = http.request(request) puts response.read_body ``` ### cURL ``` curl --request PUT \ --url 'https://api.unified.to/ats/5de520f96e439b002043d8dc/job/5de520f96e439b002043d8d8?fields=&raw=' \ --header 'accept: application/json' \ --header 'authorization: .....' ```