# Admin Groups

Administrative endpoints for managing groups, channels, and events. Provides search and listing capabilities for all groups on the server regardless of privacy or visibility. Requires Users.Read or Users.Manage permission.

## Search for groups

 - [GET /api/v1/admin/groups/search](https://docs.wellesley.social/openapi/admin-groups/paths/~1api~1v1~1admin~1groups~1search/get.md): Administrative search for groups with multiple filter criteria. Filters include member user/account linkage, group name, domain, privacy, visibility, and join mode. Returns groups regardless of visibility/privacy.

RBAC:
- requires ANY of Users.Read, Users.Manage

## Get groups by user roles

 - [GET /api/v1/admin/groups/user/{userId}](https://docs.wellesley.social/openapi/admin-groups/paths/~1api~1v1~1admin~1groups~1user~1%7Buserid%7D/get.md): Retrieves all groups where the specified user holds at least one of the given roles (e.g., owner, admin, moderator). Requires Users.Read or Users.Manage permission.

RBAC:
- requires ANY of Users.Read, Users.Manage

## Get groups owned by an account

 - [GET /api/v1/admin/groups/{accountId}](https://docs.wellesley.social/openapi/admin-groups/paths/~1api~1v1~1admin~1groups~1%7Baccountid%7D/get.md): Retrieves all groups where any user belonging to the specified account is the owner. Supports pagination. Requires Users.Read or Users.Manage permission.

RBAC:
- requires ANY of Users.Read, Users.Manage

## Get all channels for a group

 - [GET /api/v1/admin/groups/{groupId}/channels](https://docs.wellesley.social/openapi/admin-groups/paths/~1api~1v1~1admin~1groups~1%7Bgroupid%7D~1channels/get.md): Retrieves all channels belonging to a group. Channels are sub-users within a group that organize content into topics. Requires Users.Read or Users.Manage permission.

RBAC:
- requires ANY of Users.Read, Users.Manage

## Get group events

 - [GET /api/v1/admin/groups/{groupId}/events](https://docs.wellesley.social/openapi/admin-groups/paths/~1api~1v1~1admin~1groups~1%7Bgroupid%7D~1events/get.md): Retrieves all events associated with a group, skipping visibility checks. Optionally includes translations. Requires Users.Read or Users.Manage permission.

RBAC:
- requires ANY of Users.Read, Users.Manage