# CESNET Users Manager API

**Canonical:** https://apis.io/apis/cesnet/cesnet-usersmanager-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 Users 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 UsersManager. The published artifact set on APIs.io includes an OpenAPI specification, a GitHub repository, and 6 JSON Schemas.

UsersManager RPC API in Perun

## Operations (60 of 89)

| Method | Path | Summary |
|---|---|---|
| GET | `/json/usersManager/getUserById` | Returns user by its id |
| GET | `/json/usersManager/getSponsorsForMember/member` | Gets sponsors for given member with optional attribute names |
| GET | `/json/usersManager/getSponsorsForMember/vo` | Gets sponsors for member specified by VO, extSourceName and extLogin with… |
| GET | `/json/usersManager/getUserByExtSourceNameAndExtLogin` | Returns user by its ExtSourceName and ExtLogin |
| GET | `/json/usersManager/getRichUserWithAttributes` | Returns user with attributes |
| GET | `/json/usersManager/getUsers` | Returns all users |
| GET | `/json/usersManager/getAllRichUsersWithAttributes` | Returns users with attributes |
| GET | `/json/usersManager/getRichUsersByIds` | Returns rich users without attributes by their IDs |
| GET | `/json/usersManager/getRichUsersWithAttributesByIds` | Returns rich users with attributes by their IDs |
| GET | `/json/usersManager/getUserExtSources` | Gets list of all user's external sources |
| POST | `/json/usersManager/checkPasswordStrength` | Check password strength for the given namespace. |
| GET | `/json/usersManager/getGroupsWhereUserIsActive/facility` | Get list of groups of user on specified facility where use is active |
| GET | `/json/usersManager/getGroupsWhereUserIsActive/resource` | Get list of groups of user on specified resource where use is active |
| GET | `/json/usersManager/getRichGroupsWhereUserIsActive/facility` | Get list of groups of user on specified facility where use is active |
| GET | `/json/usersManager/getRichGroupsWhereUserIsActive/resource` | Get list of groups of user on specified resource where use is active |
| GET | `/json/usersManager/findUsers` | Returns list of Users with attributes who matches the searchString, searching… |
| GET | `/json/usersManager/findRichUsers` | Returns list of RichUsers with attributes who matches the searchString… |
| GET | `/json/usersManager/findRichUsersWithAttributes` | Returns list of RichUsers with attributes who matches the searchString |
| GET | `/json/usersManager/getRichUsersWithoutVoWithAttributes` | Returns list of RichUsers which are not members of any VO with attributes |
| GET | `/json/usersManager/getVosWhereUserIsMember` | Returns list of VOs, where the user is a Member |
| GET | `/json/usersManager/getVosWhereUserIsAdmin` | Returns list of VOs, where the user is an Administrator. |
| GET | `/json/usersManager/getGroupsWhereUserIsAdmin/u` | Returns list of Groups in Perun, where the User is a direct Administrator or he… |
| GET | `/json/usersManager/getGroupsWhereUserIsAdmin/u-v` | Returns list of Groups in selected Vo, where the User is a direct Administrator… |
| GET | `/json/usersManager/getRichUserExtSources/u` | Gets list of all user's external sources with attributes |
| POST | `/json/usersManager/createAlternativePassword` | Creates alternative password in external system |
| POST | `/json/usersManager/deleteAlternativePassword` | Deletes alternative password in external system |
| POST | `/urlinjsonout/usersManager/updateUserExtSourceLastAccess` | Updates user's userExtSource last access time in DB. |
| POST | `/urlinjsonout/usersManager/removeUserExtSource` | Remove user's external source. |
| POST | `/urlinjsonout/usersManager/removeUserExtSources` | Remove user's external sources. |
| GET | `/json/usersManager/getUserExtSourceById` | Returns user ext source by its id |
| GET | `/json/usersManager/getUserExtSourceByExtLoginAndExtSourceName` | Returns user's external source by the user's external login and external source… |
| GET | `/json/usersManager/getUserExtSourcesByIds` | Returns list of user ext sources by their ids |
| GET | `/json/usersManager/getUserExtSourceByUniqueAttributeValue/id` | Return userExtSource for specific attribute definition (specified by id) and… |
| GET | `/json/usersManager/getUserExtSourceByUniqueAttributeValue/name` | Return userExtSource for specific attribute definition (specified by name) and… |
| POST | `/urlinjsonout/usersManager/requestPreferredEmailChange` | Request to change preferred email address of user. |
| POST | `/json/usersManager/addUserExtSource` | Adds user's external sources |
| POST | `/json/usersManager/addUserExtSourceWithAttributes` | Adds user's external source along with the given attributes |
| POST | `/json/usersManager/validatePreferredEmailChange` | Validate new preferred email address. |
| GET | `/json/usersManager/getPendingPreferredEmailChanges` | Return list of email addresses of user, which are awaiting validation and are… |
| GET | `/json/usersManager/getAssignedRichResources` | Get all rich resources where the user is assigned. |
| GET | `/json/usersManager/getAssociatedResources` | Get all resources associated with the user on the facility |
| GET | `/json/usersManager/getUsersByIds` | Returns list of Users by their ids |
| GET | `/json/usersManager/getSpecificUsersByUser` | Get all specific users who are owned by the user |
| POST | `/urlinjsonout/usersManager/addSpecificUserOwner` | Add specific user owner |
| POST | `/urlinjsonout/usersManager/moveUserExtSource` | Move UserExtSource from one user to another |
| POST | `/urlinjsonout/usersManager/removeSpecificUserOwner` | Remove specific user owner |
| GET | `/json/usersManager/getUsersBySpecificUser` | Return all users who owns the specific user |
| GET | `/json/usersManager/getUnanonymizedUsersBySpecificUser` | Return all users who owns the specific user and are not anonymized |
| POST | `/json/usersManager/updateUser` | Updates user |
| POST | `/json/usersManager/createServiceUser` | From given candidate, creates a service user and assign given owners to him |
| POST | `/json/usersManager/checkPasswordResetRequestIsValid/token` | Checks if the password reset request is valid |
| POST | `/json/usersManager/changeNonAuthzPassword/token` | Changes user password in defined login-namespace based on token parameter |
| POST | `/json/usersManager/reservePassword/login` | Reserves password for a user in specified login-namespace |
| POST | `/json/usersManager/reservePassword/user` | Reserves password for a user in specified login-namespace |
| POST | `/urlinjsonout/usersManager/validatePassword/login` | Validate password for a user in specified login-namespace |
| POST | `/urlinjsonout/usersManager/validatePassword/user` | Validate password for a user in specified login-namespace |
| POST | `/urlinjsonout/usersManager/deletePassword/login` | Delete password for a user in specified login-namespace |
| POST | `/urlinjsonout/usersManager/deletePassword/user` | Delete password for a user in specified login-namespace |
| POST | `/json/usersManager/changePassword/login` | Changes password for a user in specified login-namespace |
| POST | `/json/usersManager/changePassword/user` | Changes password for a user in specified login-namespace |

…and 29 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-usersmanager-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 Groups Manager API](https://apis.io/apis/cesnet/cesnet-groupsmanager-api/)

## Tags

UsersManager

---

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