Update job
curl --request PATCH \
--url https://api.stardex.ai/v1/jobs/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"title": "<string>",
"job_description": "<string>",
"location": "<string>",
"job_status_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"currency_code": "<string>",
"salary_min": 1,
"salary_max": 1,
"salary_range": "<string>",
"salary_details": "<string>",
"billing_contact_name": "<string>",
"billing_contact_email": "jsmith@example.com",
"deal_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"client_contact_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"fee": 1,
"firm_commission_percent": 50,
"primary_url": "<string>",
"job_function": "<string>",
"open_date": "<string>",
"end_date": "<string>",
"is_archived": true,
"custom_fields": [
{
"attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"value": "<string>",
"add_values": [
"<string>"
],
"remove_values": [
"<string>"
],
"add_team_member_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"remove_team_member_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"add_company_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"remove_company_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"clear_all": true
}
]
}
'import requests
url = "https://api.stardex.ai/v1/jobs/{id}"
payload = {
"title": "<string>",
"job_description": "<string>",
"location": "<string>",
"job_status_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"currency_code": "<string>",
"salary_min": 1,
"salary_max": 1,
"salary_range": "<string>",
"salary_details": "<string>",
"billing_contact_name": "<string>",
"billing_contact_email": "jsmith@example.com",
"deal_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"client_contact_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"fee": 1,
"firm_commission_percent": 50,
"primary_url": "<string>",
"job_function": "<string>",
"open_date": "<string>",
"end_date": "<string>",
"is_archived": True,
"custom_fields": [
{
"attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"value": "<string>",
"add_values": ["<string>"],
"remove_values": ["<string>"],
"add_team_member_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"remove_team_member_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"add_company_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"remove_company_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"clear_all": True
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
title: '<string>',
job_description: '<string>',
location: '<string>',
job_status_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
currency_code: '<string>',
salary_min: 1,
salary_max: 1,
salary_range: '<string>',
salary_details: '<string>',
billing_contact_name: '<string>',
billing_contact_email: 'jsmith@example.com',
deal_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
client_contact_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
fee: 1,
firm_commission_percent: 50,
primary_url: '<string>',
job_function: '<string>',
open_date: '<string>',
end_date: '<string>',
is_archived: true,
custom_fields: [
{
attribute_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
value: '<string>',
add_values: ['<string>'],
remove_values: ['<string>'],
add_team_member_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
remove_team_member_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
add_company_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
remove_company_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
clear_all: true
}
]
})
};
fetch('https://api.stardex.ai/v1/jobs/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.stardex.ai/v1/jobs/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'title' => '<string>',
'job_description' => '<string>',
'location' => '<string>',
'job_status_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'currency_code' => '<string>',
'salary_min' => 1,
'salary_max' => 1,
'salary_range' => '<string>',
'salary_details' => '<string>',
'billing_contact_name' => '<string>',
'billing_contact_email' => 'jsmith@example.com',
'deal_ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'client_contact_ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'fee' => 1,
'firm_commission_percent' => 50,
'primary_url' => '<string>',
'job_function' => '<string>',
'open_date' => '<string>',
'end_date' => '<string>',
'is_archived' => true,
'custom_fields' => [
[
'attribute_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'value' => '<string>',
'add_values' => [
'<string>'
],
'remove_values' => [
'<string>'
],
'add_team_member_ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'remove_team_member_ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'add_company_ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'remove_company_ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'clear_all' => true
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.stardex.ai/v1/jobs/{id}"
payload := strings.NewReader("{\n \"title\": \"<string>\",\n \"job_description\": \"<string>\",\n \"location\": \"<string>\",\n \"job_status_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"currency_code\": \"<string>\",\n \"salary_min\": 1,\n \"salary_max\": 1,\n \"salary_range\": \"<string>\",\n \"salary_details\": \"<string>\",\n \"billing_contact_name\": \"<string>\",\n \"billing_contact_email\": \"jsmith@example.com\",\n \"deal_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"client_contact_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"fee\": 1,\n \"firm_commission_percent\": 50,\n \"primary_url\": \"<string>\",\n \"job_function\": \"<string>\",\n \"open_date\": \"<string>\",\n \"end_date\": \"<string>\",\n \"is_archived\": true,\n \"custom_fields\": [\n {\n \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"value\": \"<string>\",\n \"add_values\": [\n \"<string>\"\n ],\n \"remove_values\": [\n \"<string>\"\n ],\n \"add_team_member_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"remove_team_member_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"add_company_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"remove_company_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"clear_all\": true\n }\n ]\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.stardex.ai/v1/jobs/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"title\": \"<string>\",\n \"job_description\": \"<string>\",\n \"location\": \"<string>\",\n \"job_status_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"currency_code\": \"<string>\",\n \"salary_min\": 1,\n \"salary_max\": 1,\n \"salary_range\": \"<string>\",\n \"salary_details\": \"<string>\",\n \"billing_contact_name\": \"<string>\",\n \"billing_contact_email\": \"jsmith@example.com\",\n \"deal_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"client_contact_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"fee\": 1,\n \"firm_commission_percent\": 50,\n \"primary_url\": \"<string>\",\n \"job_function\": \"<string>\",\n \"open_date\": \"<string>\",\n \"end_date\": \"<string>\",\n \"is_archived\": true,\n \"custom_fields\": [\n {\n \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"value\": \"<string>\",\n \"add_values\": [\n \"<string>\"\n ],\n \"remove_values\": [\n \"<string>\"\n ],\n \"add_team_member_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"remove_team_member_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"add_company_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"remove_company_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"clear_all\": true\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.stardex.ai/v1/jobs/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"title\": \"<string>\",\n \"job_description\": \"<string>\",\n \"location\": \"<string>\",\n \"job_status_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"currency_code\": \"<string>\",\n \"salary_min\": 1,\n \"salary_max\": 1,\n \"salary_range\": \"<string>\",\n \"salary_details\": \"<string>\",\n \"billing_contact_name\": \"<string>\",\n \"billing_contact_email\": \"jsmith@example.com\",\n \"deal_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"client_contact_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"fee\": 1,\n \"firm_commission_percent\": 50,\n \"primary_url\": \"<string>\",\n \"job_function\": \"<string>\",\n \"open_date\": \"<string>\",\n \"end_date\": \"<string>\",\n \"is_archived\": true,\n \"custom_fields\": [\n {\n \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"value\": \"<string>\",\n \"add_values\": [\n \"<string>\"\n ],\n \"remove_values\": [\n \"<string>\"\n ],\n \"add_team_member_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"remove_team_member_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"add_company_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"remove_company_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"clear_all\": true\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"message": "Job updated successfully"
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}Jobs
Update job
Update fields on an existing job (title, job_description, status, location, salary range, salary details, billing contact name/email, fee, dates, archive state, linked deals, linked client contacts, custom fields). Use GET /v1/jobs/statuses for valid status IDs, GET /v1/custom-fields/jobs for custom field attribute IDs, and POST /v1/deals/search to resolve deal_ids for linking. Passing deal_ids fully replaces all existing deal_jobs links for the job; passing client_contact_ids fully replaces the client contacts on the job. Changes made through the API only start automations that are set to run on API and MCP changes (runs_on_api_changes), so one call cannot start runs across hundreds of records by accident.
PATCH
/
v1
/
jobs
/
{id}
Update job
curl --request PATCH \
--url https://api.stardex.ai/v1/jobs/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"title": "<string>",
"job_description": "<string>",
"location": "<string>",
"job_status_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"currency_code": "<string>",
"salary_min": 1,
"salary_max": 1,
"salary_range": "<string>",
"salary_details": "<string>",
"billing_contact_name": "<string>",
"billing_contact_email": "jsmith@example.com",
"deal_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"client_contact_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"fee": 1,
"firm_commission_percent": 50,
"primary_url": "<string>",
"job_function": "<string>",
"open_date": "<string>",
"end_date": "<string>",
"is_archived": true,
"custom_fields": [
{
"attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"value": "<string>",
"add_values": [
"<string>"
],
"remove_values": [
"<string>"
],
"add_team_member_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"remove_team_member_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"add_company_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"remove_company_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"clear_all": true
}
]
}
'import requests
url = "https://api.stardex.ai/v1/jobs/{id}"
payload = {
"title": "<string>",
"job_description": "<string>",
"location": "<string>",
"job_status_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"currency_code": "<string>",
"salary_min": 1,
"salary_max": 1,
"salary_range": "<string>",
"salary_details": "<string>",
"billing_contact_name": "<string>",
"billing_contact_email": "jsmith@example.com",
"deal_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"client_contact_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"fee": 1,
"firm_commission_percent": 50,
"primary_url": "<string>",
"job_function": "<string>",
"open_date": "<string>",
"end_date": "<string>",
"is_archived": True,
"custom_fields": [
{
"attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"value": "<string>",
"add_values": ["<string>"],
"remove_values": ["<string>"],
"add_team_member_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"remove_team_member_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"add_company_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"remove_company_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"clear_all": True
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
title: '<string>',
job_description: '<string>',
location: '<string>',
job_status_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
currency_code: '<string>',
salary_min: 1,
salary_max: 1,
salary_range: '<string>',
salary_details: '<string>',
billing_contact_name: '<string>',
billing_contact_email: 'jsmith@example.com',
deal_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
client_contact_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
fee: 1,
firm_commission_percent: 50,
primary_url: '<string>',
job_function: '<string>',
open_date: '<string>',
end_date: '<string>',
is_archived: true,
custom_fields: [
{
attribute_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
value: '<string>',
add_values: ['<string>'],
remove_values: ['<string>'],
add_team_member_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
remove_team_member_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
add_company_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
remove_company_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
clear_all: true
}
]
})
};
fetch('https://api.stardex.ai/v1/jobs/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.stardex.ai/v1/jobs/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'title' => '<string>',
'job_description' => '<string>',
'location' => '<string>',
'job_status_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'currency_code' => '<string>',
'salary_min' => 1,
'salary_max' => 1,
'salary_range' => '<string>',
'salary_details' => '<string>',
'billing_contact_name' => '<string>',
'billing_contact_email' => 'jsmith@example.com',
'deal_ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'client_contact_ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'fee' => 1,
'firm_commission_percent' => 50,
'primary_url' => '<string>',
'job_function' => '<string>',
'open_date' => '<string>',
'end_date' => '<string>',
'is_archived' => true,
'custom_fields' => [
[
'attribute_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'value' => '<string>',
'add_values' => [
'<string>'
],
'remove_values' => [
'<string>'
],
'add_team_member_ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'remove_team_member_ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'add_company_ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'remove_company_ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'clear_all' => true
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.stardex.ai/v1/jobs/{id}"
payload := strings.NewReader("{\n \"title\": \"<string>\",\n \"job_description\": \"<string>\",\n \"location\": \"<string>\",\n \"job_status_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"currency_code\": \"<string>\",\n \"salary_min\": 1,\n \"salary_max\": 1,\n \"salary_range\": \"<string>\",\n \"salary_details\": \"<string>\",\n \"billing_contact_name\": \"<string>\",\n \"billing_contact_email\": \"jsmith@example.com\",\n \"deal_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"client_contact_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"fee\": 1,\n \"firm_commission_percent\": 50,\n \"primary_url\": \"<string>\",\n \"job_function\": \"<string>\",\n \"open_date\": \"<string>\",\n \"end_date\": \"<string>\",\n \"is_archived\": true,\n \"custom_fields\": [\n {\n \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"value\": \"<string>\",\n \"add_values\": [\n \"<string>\"\n ],\n \"remove_values\": [\n \"<string>\"\n ],\n \"add_team_member_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"remove_team_member_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"add_company_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"remove_company_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"clear_all\": true\n }\n ]\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.stardex.ai/v1/jobs/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"title\": \"<string>\",\n \"job_description\": \"<string>\",\n \"location\": \"<string>\",\n \"job_status_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"currency_code\": \"<string>\",\n \"salary_min\": 1,\n \"salary_max\": 1,\n \"salary_range\": \"<string>\",\n \"salary_details\": \"<string>\",\n \"billing_contact_name\": \"<string>\",\n \"billing_contact_email\": \"jsmith@example.com\",\n \"deal_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"client_contact_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"fee\": 1,\n \"firm_commission_percent\": 50,\n \"primary_url\": \"<string>\",\n \"job_function\": \"<string>\",\n \"open_date\": \"<string>\",\n \"end_date\": \"<string>\",\n \"is_archived\": true,\n \"custom_fields\": [\n {\n \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"value\": \"<string>\",\n \"add_values\": [\n \"<string>\"\n ],\n \"remove_values\": [\n \"<string>\"\n ],\n \"add_team_member_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"remove_team_member_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"add_company_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"remove_company_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"clear_all\": true\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.stardex.ai/v1/jobs/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"title\": \"<string>\",\n \"job_description\": \"<string>\",\n \"location\": \"<string>\",\n \"job_status_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"currency_code\": \"<string>\",\n \"salary_min\": 1,\n \"salary_max\": 1,\n \"salary_range\": \"<string>\",\n \"salary_details\": \"<string>\",\n \"billing_contact_name\": \"<string>\",\n \"billing_contact_email\": \"jsmith@example.com\",\n \"deal_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"client_contact_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"fee\": 1,\n \"firm_commission_percent\": 50,\n \"primary_url\": \"<string>\",\n \"job_function\": \"<string>\",\n \"open_date\": \"<string>\",\n \"end_date\": \"<string>\",\n \"is_archived\": true,\n \"custom_fields\": [\n {\n \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"value\": \"<string>\",\n \"add_values\": [\n \"<string>\"\n ],\n \"remove_values\": [\n \"<string>\"\n ],\n \"add_team_member_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"remove_team_member_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"add_company_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"remove_company_ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"clear_all\": true\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"message": "Job updated successfully"
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}Authorizations
Authenticate with a Bearer token: API key, OAuth token, or session token.
Path Parameters
Job ID
Body
application/json
New job title.
Minimum string length:
1Plain-text job description. Replaces the existing description returned by job detail, list, and search responses.
Job location (e.g. "San Francisco, CA"). Pass null to clear.
Job status UUID. Get valid IDs from GET /v1/jobs/statuses.
ISO 4217 currency code (e.g. "USD").
Pattern:
^[A-Z]{3}$Minimum annual salary. Pass null to clear the salary range.
Required range:
x >= 0Maximum annual salary. Pass null to clear the salary range.
Required range:
x >= 0Salary range as a single number ("120000") or a dash-separated range ("80000-120000"). Parsed into the same structured range as salary_min/salary_max. Pass null to clear. Cannot be combined with salary_min or salary_max in the same request.
Maximum string length:
50Free-text salary details that complement the structured range (e.g. "+ 0.5% equity"). Max 500 characters. Pass null to clear.
Maximum string length:
500Name of the client-side billing contact (max 255 characters). Pass null to clear.
Maximum string length:
255Email of the client-side billing contact. Must be a valid email. Pass null to clear.
Maximum string length:
255Deal UUIDs to link to this job. Replaces ALL existing links in the deal_jobs join table. Pass an empty array to remove every linked deal. Omit the field to leave links unchanged. Max 50 deals per request.
Maximum array length:
50Client contact UUIDs to assign to this job. Replaces ALL contacts currently on the job. Pass an empty array to remove every contact, or omit the field to leave them unchanged. Max 50 per request.
Maximum array length:
50Placement fee amount. Pass null to clear.
Required range:
x >= 0Firm commission percentage (0–100).
Required range:
0 <= x <= 100Primary job posting URL. Pass null to clear.
Department/function (e.g. "Engineering"). Pass null to clear.
Job opening date (YYYY-MM-DD).
Pattern:
^\d{4}-\d{2}-\d{2}$Target close date (YYYY-MM-DD).
Pattern:
^\d{4}-\d{2}-\d{2}$Set true to archive the job, false to unarchive.
Custom field values to update. Get attribute definitions from GET /v1/custom-fields/jobs. For select fields, pass the tag NAME or the tag option UUID returned in that definition.
Show child attributes
Show child attributes
Was this page helpful?