Skip to main content
PATCH
Send only the fields you want to change. All fields except job_id are optional. The job must belong to your workspace.

Request Body

string
required
The job to update.
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.
string
New job title.
string
New job description (markdown).
string
Department.
string
Industry classification.
string
Country.
string
City (or null to clear).
string
One of: On-site Remote Hybrid (stored lowercase).
string
One of: Full-time Part-time Contract Freelance Internship Temporary Project-based.
string
One of: Junior Mid-level Senior Team Leader Manager Director VP C-level.
number
New salary amount.
string
Three-letter ISO currency code.
string
One of: Per hour Per day Per week Bi-weekly Per month Per year.
boolean
Hide salary on the public board.
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

string
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

boolean
Indicates if the job status was updated successfully
string
The unique identifier of the updated job
string
The new status of the job

Error Responses

Authorization Errors

400 - Bad Request
400 - Bad Request

Request Validation Errors

400 - Bad Request
400 - Bad Request
400 - Bad Request

Token Validation Errors

401 - Unauthorized
401 - Unauthorized

Job Access Errors

401 - Unauthorized