Update an employee
Change fields on an employee profile.
PATCH https://cotlet.dev/api/v1/personio/employees/{employee_id}
write Confirm
Updates the Personal Info fields you name on one profile, and returns old and new values. With Propose permissions the change goes to approval; with Edit permissions it is saved. Fields your role cannot edit are rejected by name. Compensation and other fields outside your permissions are never touched. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| employee_id string required | string | Employee ID from list_employees. |
| fields object required | object | Field names and new values, for example {"team": "Customer Success"}. |
| effective_from string | string | Date the change takes effect, YYYY-MM-DD. Default today. |
Request
curl -X PATCH https://cotlet.dev/api/v1/personio/employees/employee_8c41d2 \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"fields":"fields"}'result = client.call("personio", "update_employee", {"employee_id":"employee_8c41d2","fields":"fields"})const result = await cotlet.call('personio', 'update_employee', {"employee_id":"employee_8c41d2","fields":"fields"});cotlet call personio update_employee --data '{"employee_id":"employee_8c41d2","fields":"fields"}'Example response
{
"employee_id": "emp_2041",
"changed": {
"team": {
"from": "Marketing",
"to": "Customer Success"
},
"supervisor": {
"from": "Tom Becker",
"to": "Sam Okafor"
}
},
"status": "saved"
}