Delete a person
Erases a person for good with their leave, tasks and document records; their files stay in the store.
Free
This tool costs nothing to call.
An example
Mia Schulz left last year and asked us to delete her data. Remove her completely.
Your agent callshr_delete_personFree
The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.
{
"person": "mia.schulz@hansenvoss.example"
}Use it when
A person asks to be forgotten. To keep someone's history after they leave, set their end_date instead.
What it does
Erase a person for good with everything that is theirs: leave requests, adjustments, checklist tasks and document records, for example when they ask to be forgotten. Their files stay in the file store (files_delete removes those). Refused while they manage others: give those people another manager first. To keep someone's history after they go, set their end_date instead. Free.
What comes back
deleted: who was erased; removed: how many leave requests, adjustments, tasks and documents went with them; files_kept: their files still in the store. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
personRequired | integer or string | The person_id, or their work email. 1 to 254 characters, at least 1. |
The call
Over MCP, call hr_delete_person on https://api.conecto.chat/mcp/hr. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/hr_delete_person \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"person":"mia.schulz@hansenvoss.example"}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
not_found404 | No person of the business has that person_id or work email. | Find them with hr_list_people. |
manages_others409 | The person still manages others. | Give those people another manager first. |
More HR tools
All 23 tools- Add or change people
hr_save_peopleAdds people or changes them, up to 100 at a time, all or none: names, emails, job, department, location, manager, dates and allowances.$1.00 per person added - List people
hr_list_peoplePeople by last name, everyone who hasn't left by default, filtered by status, department, location, manager, type or words.Free* - Get a person
hr_get_personEverything about one person: details, leave balances for a year, pending and upcoming leave, documents, open tasks and direct reports.Free* - Read the HR settings
hr_get_settingsThe working days, hours, leave year, time zone, leave types, public holidays and checklists.Free* - Change the HR settings
hr_save_settingsSets the work calendar: working days, hours per day, leave year, time zone, and one location's public holidays for a year.$0.001 a call - Add or change a leave type
hr_save_leave_typeAdds or changes a kind of time off: annual days, monthly or yearly accrual, carry-over, paid and tracked.$0.001 a call - Adjust a leave balance
hr_adjust_leaveAdds days to, or takes days off, one person's balance of a tracked leave type, with the reason.$0.01 a call - Request time off
hr_request_leaveAsks for time off for someone, counting working days less holidays; it waits for a decision unless approved at once.$0.01 a call
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md