Tools / list_groups
list_groups
Lists the groups you belong to.
Annotations: readOnlyHint: true · destructiveHint: false · idempotentHint: true · openWorldHint: false
When to use it#
- To turn a group's name into its
publicId. If a name matches more than one group, ask which one is meant. - To show which groups a goal could be shared with.
It doesn't list anyone's contacts.
Inputs#
No inputs.
Returns#
{ "myGroups": [...] }, sorted by name. Each group has:
| Field | Type | Description |
|---|---|---|
publicId | string | The group's ID for other tools |
name | string | Group name |
description | string or null | Group description |
memberCount | number | Current members |
hasActiveGoal | boolean | You have an active goal shared with this group |
isModerator | boolean | You moderate this group |
Example#
json
{}
Result:
json
{
"myGroups": [
{
"publicId": "3a9f0c6e1b2d4e5f8a7b6c5d4e3f2a1b",
"name": "Founders dinner",
"description": "Operators who meet monthly.",
"memberCount": 7,
"hasActiveGoal": true,
"isModerator": false
}
]
}
Related#
get_group_detailsreads one group's roster and shared goals.- Goals and audiences explains how groups decide who reads a goal.