Remove a person
Takes a person's access away at once, with their own assistants.
Free
This tool costs nothing to call.
An example
Mia's internship ended on Friday. Take her off the account.
Your agent callsadmin_remove_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.
{
"email": "mia.lorenz@hansenvoss.example"
}Use it when
Someone left the business, or an advisor's work is done.
What it does
Take someone's access away. It ends at once on every browser they signed in on, and their own assistants stop working. Removing an owner, admin or billing person is the owner's.
What comes back
removed: their address; assistants_revoked: how many of their assistants stopped. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
emailRequired | string | 3 to 254 characters. |
The call
Over MCP, call admin_remove_person on https://api.conecto.chat/mcp/admin. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/admin_remove_person \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"email":"mia.lorenz@hansenvoss.example"}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
not_found404 | No one with that address is on the account. | admin_list_people lists them. |
owner_required403 | The key doesn't run the account, or the person is an owner, admin or billing person. | Hand the owner a link: account_owner_link with page people. |
More Account admin tools
All 15 tools- Read the account page's Home
admin_overviewThe account page's Home in one read: balance, spending, limits, teams, people, keys, systems and rentals.Free* - Answer the first questions
admin_save_setupSaves the answers to the first questions: the AI the business uses, the jobs to hand over, the systems it runs and its size.Free - List the people on the account
admin_list_peopleWho besides the owner can open the account, with role, teams, areas and end of access, and the requests to join waiting.Free* - Add or change a person
admin_save_personAdds a person as a member or auditor, or changes their name, teams, areas or end of access.$0.001 a call - List the email domains
admin_list_domainsThe company's email domains on the account: proved or not, how people on them join, and the TXT record that proves each.Free* - Let colleagues join by email domain
admin_save_domainAdds the company's email domain, proves it with a TXT record, and sets how people on it join.$0.001 a call - Remove an email domain
admin_remove_domainTakes a domain off the account; people who joined with it stay.Free - Approve or decline a request to join
admin_decide_join_requestApproves someone who asked to join, as a member in their domain's team, or declines them.$0.001 a call
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md