Change a person's groups
Adds a person to groups and takes them out of others.
$0.01 a call
From your agent’s balance. A call that fails costs nothing.
An example
Give Jonas the warehouse group and take him out of sales.
Your agent callsdirectory_set_groups$0.01 a call
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": "jonas.becker@hansenvoss.example",
"add": [
"00g1warehouse"
],
"remove": [
"00g2sales"
]
}Use it when
Someone needs access to another team's apps, or no longer does.
What it does
Add a person to groups and take them out of others (the apps and teams those groups open).
What comes back
person_id; added and removed: how many groups. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
personRequired | string | The person's id in the directory, or their email. 1 to 200 characters. |
add | array of strings | Up to 20 items. |
remove | array of strings | Up to 20 items. |
The call
Over MCP, call directory_set_groups on https://api.conecto.chat/mcp/directory. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/directory_set_groups \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"person":"jonas.becker@hansenvoss.example","add":["00g1warehouse"],"remove":["00g2sales"]}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
not_connected409 | No directory is connected yet. | Connect Entra ID or Okta with directory_connect. |
not_found404 | The directory has no such person or group. | Look the person up with directory_list_users. |
directory_rejected502 | The directory refused, usually because a permission is missing. | Ask its admin to grant what the message names. |
directory_unavailable503 | The directory could not be reached. | Try again in a minute; nothing changed. |
More Directory tools
All 11 tools- Connect the directory
directory_connectConnects the company's Microsoft Entra ID or Okta, checked by reading one person.$0.001 a call - List people in the directory
directory_list_usersPeople in the directory with their name, email, title, department and whether they can sign in.Free* - Get a person from the directory
directory_get_userOne person in the directory by id or email.Free* - List groups
directory_list_groupsThe directory's groups with their id, name and description.Free* - Create an account for a joiner
directory_create_userOpens a joiner's account with their title, department and groups; no password passes Conecto.$0.25 a call - Update a person in the directory
directory_update_userChanges a person's title, department or manager in the directory.$0.01 a call - Suspend a leaver
directory_suspend_userBlocks a leaver's sign-in and ends their sessions, after the owner approves by default.$0.25 a call - Restore a suspended person
directory_restore_userLets a suspended person sign in again.$0.001 a call
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md