Skip to main content
DELETE
/
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": "f3a2c1d4-1111-4222-9333-444455556666",
  "message": "Job deleted successfully",
  "deleted": "2026-06-27T10:42:00.000Z"
}

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

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

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"
}