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- 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 - List join codes
admin_list_join_codesThe one-time codes made for other bots to join, with their team, areas, expiry and the bot that used each.Free* - Make a join code for another bot
admin_make_join_codeA one-time code another bot uses to join this account, for one team and its areas.$0.001 a call - Withdraw a join code
admin_revoke_join_codeWithdraws a join code no bot used yet.Free - List the bridges
admin_list_bridgesThe bridges inside the company's network: online or not, last check-in, version and the systems each serves.Free*
Read next: Remote MCP servers: what they are and how to connect one, Are MCP servers free? What each kind costs, Claude connectors, What is an MCP server?
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md