Skip to main content
DELETE
https://api.hirempire.com
/
v1
/
delete-job
curl --location --request DELETE 'https://api.hirempire.com/v1/delete-job?job_id={job_id}' \
--header 'Authorization: Bearer YOUR_TOKEN'

{
  "success": true,
  "job_id": "xyz456abc123",
  "message": "Job has been deleted successfully",
  "deleted": "1970-01-01 00:00:01"
}

​
Parameters

​
job_id
string
required
The job ID to retrieve

​
Authentication

​
Authorization
string
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
curl --location --request DELETE 'https://api.hirempire.com/v1/delete-job?job_id={job_id}' \
--header 'Authorization: Bearer YOUR_TOKEN'

​
Response

​
success
boolean
Indicates if the job was deleted successfully
​
job_id
string
The unique identifier of the deleted job
​
message
string
Confirmation message about the deletion
{
  "success": true,
  "job_id": "xyz456abc123",
  "message": "Job has been deleted successfully",
  "deleted": "1970-01-01 00:00:01"
}

​
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 '."
}

​
Request Format Errors

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

400 - Bad Request 
{
    "success": false,
    "error": "Invalid token"
}
401 - Unauthorized 
{
    "success": false,
    "error": "Token is expired"
}
403 - Forbidden 
{
    "success": false,
    "error": "Token has been deleted"
}
401 - Unauthorized 
{
    "success": false,
    "error": "Token is missing required scope"
}

​
Job Access Errors

404 - Not Found 
{
    "success": false,
    "error": "Job not found."
}
401 - Unauthorized 
{
    "success": false,
    "error": "Unauthorized. You don't have the permission to delete this job."
}