Skip to main content
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,
  "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"
      ],
      "clear_all": true
    }
  ]
}
'
{
  "success": true,
  "data": {
    "message": "Job updated successfully"
  }
}

Authorizations

​
Authorization
string
header
required

Authenticate with a Bearer token: API key, OAuth token, or session token.

Path Parameters

​
id
string
required

Job ID

Body

application/json
​
title
string

New job title.

Minimum string length: 1
​
job_description
string

Plain-text or HTML job description. Replaces the existing description.

​
location
string | null

Job location (e.g. "San Francisco, CA"). Pass null to clear.

​
job_status_id
string<uuid>

Job status UUID. Get valid IDs from GET /v1/jobs/statuses.

​
currency_code
string | null

ISO 4217 currency code (e.g. "USD").

Pattern: ^[A-Z]{3}$
​
salary_min
integer | null

Minimum annual salary. Pass null to clear the salary range.

Required range: x >= 0
​
salary_max
integer | null

Maximum annual salary. Pass null to clear the salary range.

Required range: x >= 0
​
fee
number | null

Placement fee amount. Pass null to clear.

Required range: x >= 0
​
firm_commission_percent
number | null

Firm commission percentage (0–100).

Required range: 0 <= x <= 100
​
primary_url
string<uri> | null

Primary job posting URL. Pass null to clear.

​
job_function
string | null

Department/function (e.g. "Engineering"). Pass null to clear.

​
open_date
string | null

Job opening date (YYYY-MM-DD).

Pattern: ^\d{4}-\d{2}-\d{2}$
​
end_date
string | null

Target close date (YYYY-MM-DD).

Pattern: ^\d{4}-\d{2}-\d{2}$
​
is_archived
boolean

Set true to archive the job, false to unarchive.

​
custom_fields
object[]

Custom field values to update. Get attribute definitions from GET /v1/custom-fields/jobs. For select fields, pass human-readable tag names, not UUIDs.

Response

Job updated

​
success
enum<boolean>
required
Available options:
true
​
data
object
required