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
Key | Datatype | Required | Description |
---|---|---|---|
accountSwitchKey | string | (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
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string | ||
Accept | string |
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"}]}