conecto. Get started
Directory

List groups

directory_list_groups · Reads only · Markdown

The directory's groups with their id, name and description.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

An example

Which groups do we have for the warehouse?

Your agent callsdirectory_list_groupsFree*

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
{
  "query": "warehouse"
}
What comes back
{
  "groups": [
    {
      "id": "00g1warehouse",
      "name": "Warehouse",
      "description": "The warehouse team"
    },
    {
      "id": "00g2sales",
      "name": "Sales",
      "description": "The sales team"
    }
  ],
  "count": 2
}

Use it when

To find the group ids a joiner should get.

What it does

The directory's groups, with their id, name and description (which apps and teams they open).

What comes back

groups: each with id, name and description; count. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
querystringUp to 100 characters.
limitinteger1 to 200. Default: 100.

The call

Over MCP, call directory_list_groups on https://api.conecto.chat/mcp/directory. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/directory_list_groups \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"warehouse"}'

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
not_connected409No directory is connected yet.Connect Entra ID or Okta with directory_connect.
directory_rejected502The directory refused, usually because a permission is missing.Ask its admin to grant what the message names.
directory_unavailable503The directory could not be reached.Try again in a minute; nothing changed.

More Directory tools

All 11 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md