Skip to content
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:

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 (synthetic data):

json
{
  "myGroups": [
    {
      "publicId": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "name": "Synthetic founders",
      "description": null,
      "memberCount": 2,
      "hasActiveGoal": true,
      "isModerator": false
    }
  ]
}