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

{
  "success": true,
  "id": "xyz456abc123",
  "status": "Rejected"
}

​
Request Body

​
applicant_id
string
required
The unique identifier of the applicant to update
​
status
string
required
The new status for the applicant. Valid values: Applied, Reviewed, Accepted, Scheduled, Met, Hired, Rejected

​
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-applicant' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
    "applicant_id": "xyz456abc123",
    "status": "Rejected"
}'

​
Response

​
success
boolean
Indicates if the applicant status was updated successfully
​
id
string
The unique identifier of the updated applicant
​
status
string
The new status of the applicant
{
  "success": true,
  "id": "xyz456abc123",
  "status": "Rejected"
}