# CESNET Vos Manager API

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

VosManager RPC API in Perun

## Operations (41)

| Method | Path | Summary |
|---|---|---|
| GET | `/json/vosManager/getVos` | Return list of all VOs the caller is associated with |
| GET | `/json/vosManager/getEnrichedVos` | Return list of all EnrichedVos the caller is associated with |
| GET | `/json/vosManager/getAllVos` | Return list of all VOs in Perun |
| POST | `/urlinjsonout/vosManager/deleteVo` | Deletes a VO. |
| POST | `/json/vosManager/createVo/withVo` | Creates new VO. |
| POST | `/urlinjsonout/vosManager/createVo/withName` | Creates new VO. Caller is automatically set as VO manager |
| POST | `/json/vosManager/updateVo` | Updates a VO. |
| GET | `/json/vosManager/getVoByShortName` | Returns a VO by its short name |
| GET | `/json/vosManager/getVoById` | Returns a virtual organization by id |
| GET | `/json/vosManager/getEnrichedVoById` | Returns an enriched virtual organization by id |
| GET | `/json/vosManager/getVosByIds` | Return list of VOs by their ids |
| GET | `/json/vosManager/findCandidates` | Find candidates for VO. |
| GET | `/json/vosManager/findCandidates/forGroup` | Find candidates for Group. |
| GET | `/json/vosManager/getCompleteCandidates/forVo` | Find MemberCandidates for VO. |
| GET | `/json/vosManager/getCompleteCandidates/forGroup` | Find MemberCandidates for GROUP. |
| GET | `/json/vosManager/getVosCount` | Gets count of all vos |
| GET | `/json/vosManager/getVoMembersCountsByStatus` | Returns number of vo members by their status |
| POST | `/urlinjsonout/vosManager/addAdmin/user` | Adds a user as a Vo admin |
| POST | `/urlinjsonout/vosManager/addAdmin/group` | Adds a group as a Vo admin |
| POST | `/urlinjsonout/vosManager/addSponsorRole/user` | Add user as a sponsor for guest members of VO |
| POST | `/urlinjsonout/vosManager/addSponsorRole/group` | Add group as a sponsor of guest members of VO. |
| POST | `/urlinjsonout/vosManager/removeAdmin/user` | Removes a user as a Vo admin |
| POST | `/urlinjsonout/vosManager/removeAdmin/group` | Removes a group as a Vo admin |
| POST | `/urlinjsonout/vosManager/removeSponsorRole/user` | Removes user as a sponsor. |
| POST | `/urlinjsonout/vosManager/removeSponsorRole/group` | Removes group as a sponsor. |
| GET | `/json/vosManager/getAdmins` | Get vo admin users |
| GET | `/json/vosManager/getAdminGroups` | Get vo admin groups |
| GET | `/json/vosManager/getRichAdmins` | Get rich admins for vo |
| POST | `/json/vosManager/setBan` | Set vo ban |
| POST | `/urlinjsonout/vosManager/removeBan` | Remove vo ban with given id |
| POST | `/urlinjsonout/vosManager/removeBanForMember` | Remove vo ban for member with given id |
| POST | `/json/vosManager/updateBan` | Update existing ban (description, validation timestamp) |
| GET | `/json/vosManager/getBanById` | Get vo ban with given id |
| GET | `/json/vosManager/getBanForMember` | Get ban for given member, or null if he is not banned |
| GET | `/json/vosManager/getBansForVo` | Get list of all bans for vo with given id |
| GET | `/json/vosManager/getEnrichedBansForVo` | Get list of all enriched bans for vo |
| GET | `/json/vosManager/getEnrichedBansForUser` | Get list of all enriched bans for user |
| POST | `/urlinjsonout/vosManager/addMemberVo` | Add member vo to vo |
| POST | `/urlinjsonout/vosManager/removeMemberVo` | Remove member vo from vo |
| GET | `/json/vosManager/getMemberVos` | Get list of all members organizations of a vo |
| GET | `/json/vosManager/getParentVos` | Get list of all parent organizations of a vo |

## Machine-readable artifacts (9)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/cesnet/refs/heads/main/openapi/cesnet-vosmanager-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

VosManager

---

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