Skip to main content
PATCH
/
v1
/
update-job
curl --location --request PATCH 'https://api.hirempire.com/v1/update-job' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
    "job_id": "xyz456abc123",
    "status": "Active"
}'

{
  "success": true,
  "id": "f3a2c1d4-1111-4222-9333-444455556666",
  "status": "active"
}
Send only the fields you want to change. All fields except job_id are optional. The job must belong to your workspace.

​
Request Body

​
job_id
string
required
The job to update.
​
status
string
New status. Accepted input values: Pending Active Paused Hired Closed. Pending maps to draft. Hired is accepted as a deprecated alias for Closed. Storage and response always use the canonical lowercase value: draft active paused closed.
​
job_title
string
New job title.
​
job_description
string
New job description (markdown).
​
department
string
Department.
​
industry
string
Industry classification.
​
job_country
string
Country.
​
city
string
City (or null to clear).
​
workplace
string
One of: On-site Remote Hybrid (stored lowercase).
​
job_type
string
One of: Full-time Part-time Contract Freelance Internship Temporary Project-based.
​
career_level
string
One of: Junior Mid-level Senior Team Leader Manager Director VP C-level.
​
salary
number
New salary amount.
​
currency
string
Three-letter ISO currency code.
​
salary_period
string
One of: Per hour Per day Per week Bi-weekly Per month Per year.
​
hide_salary
boolean
Hide salary on the public board.
​
questions
object
Replace the application form configuration. See Get specific job for the { fields, custom } structure.
At least one field beyond job_id must be provided. Otherwise the response is 400 At least one updatable field must be provided.

​
Authentication

​
Authorization
string
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
curl --location --request PATCH 'https://api.hirempire.com/v1/update-job' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
    "job_id": "xyz456abc123",
    "status": "Active"
}'

​
Response

​
success
boolean
Indicates if the job status was updated successfully
​
id
string
The unique identifier of the updated job
​
status
string
The new status of the job
{
  "success": true,
  "id": "f3a2c1d4-1111-4222-9333-444455556666",
  "status": "active"
}

​
Error Responses

​
Authorization Errors

400 - Bad Request 
{
    "success": false,
    "error": "Authorization header is required."
}
400 - Bad Request 
{
    "success": false,
    "error": "Authorization header must start with 'Bearer '."
}

​
Request Validation Errors

400 - Bad Request 
{
    "success": false,
    "error": "Job ID is required and cannot be empty."
}
400 - Bad Request 
{
    "success": false,
    "error": "Job status is required and cannot be empty."
}
400 - Bad Request 
{
    "success": false,
    "error": "status must be one of: Pending, Active, Paused, Hired, Closed"
}

​
Token Validation Errors

401 - Unauthorized 
{
    "success": false,
    "error": "Invalid token"
}
401 - Unauthorized 
{
    "success": false,
    "error": "Token is expired"
}

​
Job Access Errors

401 - Unauthorized 
{
    "success": false,
    "error": "Invalid job id"
}