Create a role

POST https://{{host}}/identity-management/v3/user-admin/roles

This operation creates a custom role. A custom role combines grantable roles defined by Akamai. Roles exist at the account level regardless of group, but are constrained by contract type. If you create a role under one contract type, you can't apply that role to groups belonging to a different contract type, even if they're in the same account.

Request Params

KeyDatatypeRequiredDescription
accountSwitchKeystring(Optional) For customers who manage more than one account, this runs the operation from another account. The Identity and Access Management API provides a list of available account switch keys.

Request Body

{"grantedRoles"=>[{"grantedRoleId"=>2051}], "roleDescription"=>"This role lets users edit or create reports.", "roleName"=>"Edit Reports"}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: Created

{"actions":{"delete":true,"edit":true},"createdBy":"alfulani","createdDate":"2017-09-11T13:43:54.005Z","grantedRoles":[{"grantedRoleDescription":"View Real User Monitoring","grantedRoleId":1234,"grantedRoleName":"RealUserMonitoring - View Only"}],"modifiedBy":"mrossi","modifiedDate":"2017-09-11T13:43:54.005Z","roleDescription":"Provides users with edit and create access to reports.","roleId":12345678,"roleName":"Edit Role","type":"custom","users":[{"accountId":"A-CCT5678","email":"jsmith@example.com","firstName":"John","lastLoginDate":"2016-01-13T17:53:57Z","lastName":"Smith","uiIdentityId":"A-B-12345"}]}