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