# CESNET Groups Manager API

**Canonical:** https://apis.io/apis/cesnet/cesnet-groupsmanager-api/  
**Provider:** CESNET — https://apis.io/providers/cesnet/  
**Base URL:** https://api-dev.perun-aai.org/ba/rpc  
**Documentation:** https://perun-aai.org/documentation/

CESNET Groups Manager API is one of 27 APIs that [CESNET](https://apis.io/providers/cesnet/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include GroupsManager. The published artifact set on APIs.io includes an OpenAPI specification, a GitHub repository, and 6 JSON Schemas.

GroupsManager RPC API in Perun

## Operations (60 of 66)

| Method | Path | Summary |
|---|---|---|
| GET | `/json/groupsManager/getGroupById` | Returns a group by id |
| GET | `/json/groupsManager/getGroupByUUID` | Returns a group by uuid |
| GET | `/json/groupsManager/getRichGroupByIdWithAttributesByNames` | Returns RichGroup selected by id containing selected attributes |
| GET | `/json/groupsManager/getGroupByName` | Get group by name |
| GET | `/json/groupsManager/getGroupsByIds` | Returns list of groups by their ids |
| GET | `/json/groupsManager/getSubGroups` | Returns direct subgroups of a group (single level) |
| GET | `/json/groupsManager/getGroupMembers` | Returns list of members of a group |
| GET | `/json/groupsManager/isGroupLastAdminInSomeFacility` | Return groups which supply the last FACILITYADMIN in some Facility |
| GET | `/json/groupsManager/isGroupLastAdminInSomeVo` | Returns groups which supply the last VOADMIN in some VO |
| GET | `/json/groupsManager/isGroupMember` | Return true if Member is member of the Group |
| GET | `/json/groupsManager/getMemberGroups` | Returns groups for a member |
| GET | `/json/groupsManager/getAllMemberGroups` | Returns all groups for a member including group 'members' |
| GET | `/json/groupsManager/getAllGroups/all` | Get all groups from all vos. |
| GET | `/json/groupsManager/getAllGroups` | Returns all groups in a VO |
| GET | `/json/groupsManager/getGroups` | Returns all groups in a VO the user has access to |
| GET | `/json/groupsManager/getAllRichGroups` | Get all groups with their specified attributes. |
| GET | `/json/groupsManager/getAllRichGroupsWithAttributesByNames` | Returns full list of all RichGroups containing selected attributes |
| GET | `/json/groupsManager/getAllRichSubGroupsWithAttributesByNames` | Returns all AllRichSubGroups from parent group containing selected attributes… |
| POST | `/urlinjsonout/groupsManager/createGroup/v-n-d` | Create group with vo name description |
| POST | `/urlinjsonout/groupsManager/createGroup/pg-n-d` | Create group with parent group name description |
| POST | `/urlinjsonout/groupsManager/deleteGroup` | Deletes group with given id if it contains no members and group is not assigned… |
| POST | `/json/groupsManager/deleteGroups` | Forcefully deletes a list of groups (remove all group members, remove group… |
| POST | `/urlinjsonout/groupsManager/getGroupsWhereAutoRegistrationWillBeBrokenByMovingGroup/dg-mg` | The groups embedded for an auto-registration in a group form need to be… |
| POST | `/urlinjsonout/groupsManager/moveGroup/dg-mg` | Moves "movingGroup" (including subGroups) under "destinationGroup" as subGroup… |
| POST | `/urlinjsonout/groupsManager/addMember` | Add member to groups. If already a member of a group, the group will be skipped |
| POST | `/urlinjsonout/groupsManager/addMembers` | Adds members to a group. |
| POST | `/urlinjsonout/groupsManager/copyMembers` | Copies direct members from one group to other groups within the same VO. |
| POST | `/urlinjsonout/groupsManager/removeMember` | Removes member from a groups. |
| POST | `/urlinjsonout/groupsManager/removeMembers` | Removes members from a group. |
| POST | `/json/groupsManager/removeMembers` | Removes members from a group. |
| POST | `/urlinjsonout/groupsManager/createGroupUnion` | Create union of two groups, where "operandGroup" is technically set as subgroup… |
| GET | `/json/groupsManager/getGroupUnions` | Return all operand groups for specified result groups (all INCLUDED groups). |
| POST | `/urlinjsonout/groupsManager/setGroupsMemberStatus` | Set membership status of a member in a group. |
| POST | `/urlinjsonout/groupsManager/extendMembershipInGroup` | Extend member membership in given group using membershipExpirationRules… |
| GET | `/json/groupsManager/canExtendMembershipInGroup` | Returns true if member in given group can extend membership or if no rules were… |
| GET | `/json/groupsManager/canExtendInNewRegistrarGroup` | Returns true if member in given group can extend membership or if no rules were… |
| POST | `/urlinjsonout/groupsManager/removeGroupUnion` | Removes union of two groups, when "operandGroup" is technically removed from… |
| POST | `/urlinjsonout/groupsManager/removeGroupUnions` | Removes unions of groups, where "operandGroups" are technically removed from… |
| POST | `/urlinjsonout/groupsManager/forceGroupSynchronization` | Forces group synchronization |
| POST | `/urlinjsonout/groupsManager/forceGroupStructureSynchronization` | Forces group structure synchronization |
| POST | `/urlinjsonout/groupsManager/forceAllSubGroupsSynchronization` | Force synchronization for all subgroups (recursively - whole tree) of the group… |
| POST | `/json/groupsManager/updateGroup` | Updates a group |
| GET | `/json/groupsManager/getGroupMembersCount` | Returns count of group members |
| GET | `/json/groupsManager/getGroupDirectMembersCount` | Returns count of direct group members |
| GET | `/json/groupsManager/getGroupMembersCountsByVoStatus` | Returns counts of group members by their status in VO |
| GET | `/json/groupsManager/getGroupMembersCountsByGroupStatus` | Returns counts of group members by their group status |
| GET | `/json/groupsManager/getMemberRichGroupsWithAttributesByNames` | Returns full list of member's RichGroups containing selected attributes. |
| GET | `/json/groupsManager/getParentGroup` | Returns a parent group of a group |
| GET | `/json/groupsManager/getAllSubGroups` | Returns all subgroups of a group |
| GET | `/json/groupsManager/getIndirectMembershipPaths` | Returns unique paths of groups as list of lists of groups [CURRENT GROUP ->… |
| GET | `/json/groupsManager/getGroupMemberById` | Get member in context of group |
| GET | `/json/groupsManager/getGroupRichMembersByIds` | Returns list of RichMembers with requested attributes by their member IDs from… |
| POST | `/json/groupsManager/getGroupsPage` | Get page of groups from the given vo |
| POST | `/json/groupsManager/getSubgroupsPage` | Get page of subgroups from the given parent group |
| POST | `/urlinjsonout/groupsManager/allowGroupToHierarchicalVo` | Sets flag required for including group to parent vo in a vo hierarchy |
| POST | `/urlinjsonout/groupsManager/allowGroupsToHierarchicalVo` | Sets flag required for including groups to parent vo in a vo hierarchy |
| POST | `/urlinjsonout/groupsManager/disallowGroupToHierarchicalVo` | Unsets flag required for including group to parent vo in a vo hierarchy |
| POST | `/urlinjsonout/groupsManager/disallowGroupsToHierarchicalVo` | Unsets flag required for including groups to parent vo in a vo hierarchy |
| GET | `/json/groupsManager/isAllowedGroupToHierarchicalVo` | Returns flag representing if the group can be included in the (parent) vo's… |
| GET | `/json/groupsManager/getAllAllowedGroupsToHierarchicalVo/v` | Returns all groups which can be included to VO |

…and 6 more operations. They are listed in full on the page.

## Machine-readable artifacts (9)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/cesnet/refs/heads/main/openapi/cesnet-groupsmanager-api-openapi.yml
- **GitHubRepository** — https://github.com/CESNET/perun
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/cesnet/refs/heads/main/json-schema/cesnet-application-form-item-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/cesnet/refs/heads/main/json-schema/cesnet-perun-notif-template-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/cesnet/refs/heads/main/json-schema/cesnet-application-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/cesnet/refs/heads/main/json-schema/cesnet-registrar-application-input-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/cesnet/refs/heads/main/json-schema/cesnet-applications-page-query-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/cesnet/refs/heads/main/json-schema/cesnet-publication-schema.json
- **GitHubRepository** — https://github.com/CESNET/exafs

## Other CESNET APIs (12)

- [CESNET Attributes Manager API](https://apis.io/apis/cesnet/cesnet-attributesmanager-api/)
- [CESNET Audit Messages Manager API](https://apis.io/apis/cesnet/cesnet-auditmessagesmanager-api/)
- [CESNET Authorization API](https://apis.io/apis/cesnet/cesnet-authorization-api/)
- [CESNET Authz Resolver API](https://apis.io/apis/cesnet/cesnet-authzresolver-api/)
- [CESNET Cabinet Manager API](https://apis.io/apis/cesnet/cesnet-cabinetmanager-api/)
- [CESNET Choices API](https://apis.io/apis/cesnet/cesnet-choices-api/)
- [CESNET Config Manager API](https://apis.io/apis/cesnet/cesnet-configmanager-api/)
- [CESNET Consents Manager API](https://apis.io/apis/cesnet/cesnet-consentsmanager-api/)
- [CESNET Database Manager API](https://apis.io/apis/cesnet/cesnet-databasemanager-api/)
- [CESNET Ext Sources Manager API](https://apis.io/apis/cesnet/cesnet-extsourcesmanager-api/)
- [CESNET Facilities Manager API](https://apis.io/apis/cesnet/cesnet-facilitiesmanager-api/)
- [CESNET Integration Manager API](https://apis.io/apis/cesnet/cesnet-integrationmanager-api/)

## Tags

GroupsManager

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/cesnet/cesnet-groupsmanager-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/cesnet/.