Browse the help center

Create a role

Adds a role built on one of the static roles 'staticRoles' lists -- the static role decides which permissions the new role can hold at all and which console the accounts holding it enter, and it cannot be changed afterwards.

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

Adds a role built on one of the static roles 'staticRoles' lists -- the static role decides which permissions the new role can hold at all and which console the accounts holding it enter, and it cannot be changed afterwards. 'copyFrom' starts the new role from another role's permissions and admin console pages instead of from nothing; without it the role starts with no permissions and is given the User Roles & Permissions page, as the console does. A role built on ADMIN needs the Create ADMIN-based role permission. Requires the Admin Roles & Permissions or User Roles & Permissions console permission.

Form Params

name string required

The role's name, as the console shows it

Campaign manager

staticRole string required

The static role to build on: its id, or its name as 'staticRoles' spells it

NETWORK_MANAGER

copyFrom integer

Start from this role's permissions and admin console pages

4

Responses

200

{success, id, name, staticRole, identity, manageable}

400

The name is blank or taken, the static role is unknown or deprecated, or 'copyFrom' names no role

401

Authentication error

403

The caller may not build a role on that static role, or may not copy that one

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.