Tools / list_groups
View as Markdown

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:

FieldTypeDescription
publicIdstringThe group's ID for other tools
namestringGroup name
descriptionstring or nullGroup description
memberCountnumberCurrent members
hasActiveGoalbooleanYou have an active goal shared with this group
isModeratorbooleanYou moderate this group

Example#

json
{}

Result:

json
{
  "myGroups": [
    {
      "publicId": "3a9f0c6e1b2d4e5f8a7b6c5d4e3f2a1b",
      "name": "Founders dinner",
      "description": "Operators who meet monthly.",
      "memberCount": 7,
      "hasActiveGoal": true,
      "isModerator": false
    }
  ]
}