Browse docslist_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 (synthetic data):
json
{
"myGroups": [
{
"publicId": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"name": "Synthetic founders",
"description": null,
"memberCount": 2,
"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.