Browse the help center

List the network's roles

Every role the caller may see, as the console's roles pages list them: its id, the static role it is built on (which decides the permissions it can hold at all), the admin console pages it opens, and whether the caller may change it and hand it to an account.

Reference
GET https://YOUR-NETWORK-DOMAIN/rest-api/roles.do

Every role the caller may see, as the console's roles pages list them: its id, the static role it is built on (which decides the permissions it can hold at all), the admin console pages it opens, and whether the caller may change it and hand it to an account. A role built on ADMIN is listed only to a caller who may edit admin roles. 'identity' is how this role is addressed in another role's permission matrix, where the rights one role holds over another live. How many accounts hold a role is answered by system-users/search.do with that role. Requires the Admin Roles & Permissions or User Roles & Permissions console permission.

Responses

200

{success, adminRolesVisible, roles:[{id, name, staticRole, identity, adminPages, manageable}], staticRoles:[{id, name}]}

400

Bad request — invalid or missing parameters

401

Authentication error

403

The caller holds neither roles-and-permissions console permission

Please disable Adblock
Are you using adblock? Disable it and reload the page to proceed to the destination page.

A registration has already been submitted from this page. Please try again in 10 minutes.