List groups

GET/v1/directory/groups

Lists your organization's groups and the people in each.

Permission: identity:ListGroups

Returns

200 OK

{
  "groups": [
    {
      "id": "3c5e8a90-1d2b-4e6f-8a7c-9b0d1e2f3a4b",
      "name": "Engineering",
      "description": "Everyone who ships code",
      "members": [
        "8f0c2c1e-6b1a-4f3e-9a51-0c3d2f7e9b10"
      ],
      "created_at": "2026-11-19T09:00:00Z",
      "updated_at": "2026-11-19T09:00:00Z"
    }
  ]
}

Example

curl https://<company>.yotta.bot/v1/directory/groups \
  -H "Authorization: Bearer $YOTTABOT_TOKEN"

With yottactl

yottactl org groups list