Account admin
Remove an email domain
Takes a domain off the account; people who joined with it stay.
Free
This tool costs nothing to call.
An example
We closed the used-equipment outlet. Stop people joining with its addresses.
Your agent callsadmin_remove_domainFree
The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.
With these arguments
{
"domain": "hansenvoss-outlet.example"
}What comes back
Use it when
The company stopped using the domain, or joining with it should stop for good.
What it does
Take a domain off the account: nobody joins or asks to join with it any more. People who joined stay.
What comes back
removed: the domain. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
domainRequired | string | The part of the company's addresses after the @, like hansenvoss.example. 4 to 253 characters. |
The call
Over MCP, call admin_remove_domain on https://api.conecto.chat/mcp/admin. Over REST:
Terminal
curl -X POST https://api.conecto.chat/v1/tools/admin_remove_domain \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"domain":"hansenvoss-outlet.example"}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
not_found404 | That domain is not on the account. | admin_list_domains lists them. |
invalid_input400 | The domain is not one. | Send it like hansenvoss.example. |
owner_required403 | The key is not one that runs the account: it works for one team, has limits, or is a member's assistant. | Use a key of the company-wide team without limits, or ask the owner (account_owner_link). |
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 - Remove a person
admin_remove_personTakes a person's access away at once, with their own assistants.Free - 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 - 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