Skip to main content
PUT
/
api
/
candidates
/
{id}
curl --request PUT \
  --url https://api.harmonyforstaffing.com/api/candidates/456 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "firstName": "John",
    "lastName": "Doe",
    "email": "john.doe@example.com",
    "phone": "+1-555-555-5555",
    "address": {
      "address1": "123 Main St",
      "city": "San Francisco",
      "state": "CA",
      "zip": "94105",
      "countryCode": "US"
    },
    "notes": "Excellent communication skills, available immediately",
    "profession": "Software Engineer",
    "specialty": "Frontend Development",
    "status": "ACTIVE"
  }'

{
  "id": 456,
  "firstName": "John",
  "lastName": "Doe",
  "email": "john.doe@example.com",
  "phone": "+1-555-555-5555",
  "address": {
    "address1": "123 Main St",
    "city": "San Francisco",
    "state": "CA",
    "zip": "94105",
    "countryCode": "US"
  },
  "notes": "Excellent communication skills, available immediately",
  "profession": "Software Engineer",
  "specialty": "Frontend Development",
  "status": "ACTIVE",
  "dateAdded": 1679253000
}
Update the details of an existing candidate.

​
Path Parameters

​
id
number
required
ID of the candidate to update

​
Body Parameters

​
firstName
string
Updated first name
​
lastName
string
Updated last name
​
email
string
Updated email address
​
phone
string
Updated contact phone number
​
address
object
Updated address information
​
notes
string
Additional notes about the candidate
​
profession
string
Candidate’s primary profession
​
specialty
string
Candidate’s specialty or focus area
​
status
string
Current status of the candidate

​
Response

​
id
number
The ID of the updated candidate
​
firstName
string
First name
​
lastName
string
Last name
​
email
string
Email address
​
phone
string
Phone number
​
address
object
Address information
​
notes
string
Additional notes
​
profession
string
Primary profession
​
specialty
string
Specialty or focus area
​
status
string
Current status
​
dateAdded
integer
Unix timestamp when the candidate was added
curl --request PUT \
  --url https://api.harmonyforstaffing.com/api/candidates/456 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "firstName": "John",
    "lastName": "Doe",
    "email": "john.doe@example.com",
    "phone": "+1-555-555-5555",
    "address": {
      "address1": "123 Main St",
      "city": "San Francisco",
      "state": "CA",
      "zip": "94105",
      "countryCode": "US"
    },
    "notes": "Excellent communication skills, available immediately",
    "profession": "Software Engineer",
    "specialty": "Frontend Development",
    "status": "ACTIVE"
  }'

{
  "id": 456,
  "firstName": "John",
  "lastName": "Doe",
  "email": "john.doe@example.com",
  "phone": "+1-555-555-5555",
  "address": {
    "address1": "123 Main St",
    "city": "San Francisco",
    "state": "CA",
    "zip": "94105",
    "countryCode": "US"
  },
  "notes": "Excellent communication skills, available immediately",
  "profession": "Software Engineer",
  "specialty": "Frontend Development",
  "status": "ACTIVE",
  "dateAdded": 1679253000
}