Parameters
Authentication
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
cURL
JavaScript
Python
PHP
Ruby
Go
Java
C#
Swift
Kotlin
Rust
curl --location --request DELETE 'https://api.hirempire.com/v1/delete-job?job_id={job_id}' \
--header 'Authorization: Bearer YOUR_TOKEN'
Response
Indicates if the job was deleted successfully
The unique identifier of the deleted job
Confirmation message about the deletion
{
"success" : true ,
"job_id" : "f3a2c1d4-1111-4222-9333-444455556666" ,
"message" : "Job deleted successfully" ,
"deleted" : "2026-06-27T10:42:00.000Z"
}
Jobs are soft-deleted — they are flagged as archived rather than removed from the database. The id of an archived job remains stable; subsequent GET requests for that id return 404 Not Found.
Error Responses
Authorization Errors
400 - Bad Request
{
"success" : false ,
"error" : "Missing 'Authorization' header."
}
400 - Bad Request
{
"success" : false ,
"error" : "Authorization header must start with 'Bearer '."
}
400 - Bad Request
{
"success" : false ,
"error" : "Request params are not allowed."
}
400 - Bad Request
{
"success" : false ,
"error" : "Request body is not allowed."
}
400 - Bad Request
{
"success" : false ,
"error" : "Missing required query parameter 'job_id'."
}
400 - Bad Request
{
"success" : false ,
"error" : "Only 'job_id' query parameter is allowed."
}
Token Validation Errors
401 - Unauthorized
{
"success" : false ,
"error" : "Invalid token"
}
401 - Unauthorized
{
"success" : false ,
"error" : "Token is expired"
}
Job Access Errors
404 - Not Found
{
"success" : false ,
"error" : "Job not found"
}