Workforce
Update employee
Call Outcome
Company Category
Contract Type
Custom Field
Delivery Method
Industry
Lead Source
Loss Reason
Market Sector
Project Stages
Task List
Tender Type
Webhook Message
Workforce
Update employee
PATCH
/
api
/
2023-01
/
workforce
/
employees
/
{id}
curl --request PATCH \
--url https://api.buildr.com/api/2023-01/workforce/employees/{id} \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--data '{
"workforce_employee": {
"birthday": "2021-01-01",
"email": "anthony@example.com",
"last_name": "Edwards",
"legal_first_name": "Anthony",
"notes": "This is why you always leave a note",
"phone": "555-555-5555",
"preferred_first_name": "Tony",
"role_id": "734",
"start_date": "2021-01-01",
"manager_id": "140"
}
}'
{
"workforce_employee": {
"id": "140",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"birthday": "2021-01-01",
"last_name": "Edwards",
"legal_first_name": "Anthony",
"notes": "This is why you always leave a note",
"phone": "555-555-5555",
"preferred_first_name": "Tony",
"start_date": "2021-01-01",
"email": "anthony@example.com",
"address": {
"street_address": "123 Main St",
"street_address2": "Apt 1",
"city": "Los Angeles",
"state": "CA",
"zip": "90001",
"country": "US"
},
"role": {
"id": "734",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"name": "Project Manager",
"abbreviation": "PM"
},
"manager": {
"id": "687",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"legal_first_name": "Markus",
"preferred_first_name": "Mookie",
"last_name": "Betts",
"email": "mookie@example.com",
"role": {
"id": "734",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"name": "Project Manager",
"abbreviation": "PM"
}
}
}
}
Headers
Path Parameters
Body
application/json
Example:
"2021-01-01"
Example:
"anthony@example.com"
Example:
"Edwards"
Example:
"Anthony"
Example:
"This is why you always leave a note"
Example:
"555-555-5555"
Example:
"Tony"
Role ID to be associated with this employee
Example:
"734"
Example:
"2021-01-01"
Workforce Employee Manager to be associated with this employee
Example:
"140"
Response
200 - application/json
Successful Response
Example:
"140"
Example:
"2023-02-14T18:13:00Z"
Example:
"2023-04-03T20:16:30Z"
Example:
"2021-01-01"
Example:
"Edwards"
Example:
"Anthony"
Example:
"This is why you always leave a note"
Example:
"555-555-5555"
Example:
"Tony"
Example:
"2021-01-01"
Example:
"anthony@example.com"
Example:
"123 Main St"
Example:
"Apt 1"
Example:
"Los Angeles"
Example:
"90001"
Available options:
AU
, CA
, GB
, IS
, NZ
, UK
, US
Example:
"US"
Example:
"CA"
Example:
"734"
Example:
"2023-02-14T18:13:00Z"
Example:
"2023-04-03T20:16:30Z"
Example:
"Project Manager"
Example:
"PM"
Example:
"687"
Example:
"2023-02-14T18:13:00Z"
Example:
"2023-04-03T20:16:30Z"
Example:
"Markus"
Example:
"Betts"
Example:
"mookie@example.com"
Example:
"734"
Example:
"2023-02-14T18:13:00Z"
Example:
"2023-04-03T20:16:30Z"
Example:
"Project Manager"
Example:
"PM"
Example:
"Mookie"
curl --request PATCH \
--url https://api.buildr.com/api/2023-01/workforce/employees/{id} \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--data '{
"workforce_employee": {
"birthday": "2021-01-01",
"email": "anthony@example.com",
"last_name": "Edwards",
"legal_first_name": "Anthony",
"notes": "This is why you always leave a note",
"phone": "555-555-5555",
"preferred_first_name": "Tony",
"role_id": "734",
"start_date": "2021-01-01",
"manager_id": "140"
}
}'
{
"workforce_employee": {
"id": "140",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"birthday": "2021-01-01",
"last_name": "Edwards",
"legal_first_name": "Anthony",
"notes": "This is why you always leave a note",
"phone": "555-555-5555",
"preferred_first_name": "Tony",
"start_date": "2021-01-01",
"email": "anthony@example.com",
"address": {
"street_address": "123 Main St",
"street_address2": "Apt 1",
"city": "Los Angeles",
"state": "CA",
"zip": "90001",
"country": "US"
},
"role": {
"id": "734",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"name": "Project Manager",
"abbreviation": "PM"
},
"manager": {
"id": "687",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"legal_first_name": "Markus",
"preferred_first_name": "Mookie",
"last_name": "Betts",
"email": "mookie@example.com",
"role": {
"id": "734",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"name": "Project Manager",
"abbreviation": "PM"
}
}
}
}