Akamai APIs API Documentation
List roles
GET https://{{host}}/identity-management/v3/user-admin/roles
This operation lists roles for the current account and contract type or other accounts using the accountSwitchKey parameter. The account and contract type are determined by the access tokens in your API client.
Body
PARAM
| Key | Datatype | Required | Description |
actions
|
string | (Optional) Includes information about actions such as `edit` or `delete` that you can take for the object, `false` by default. Don't confuse this with the `action` parameter, which applies to the [Set two-factor authentication](https://techdocs.akamai.com/iam-api/reference/put-user-profile-tfa) operation. | |
groupId
|
string | (Optional) Filters roles for a specific group. To get this value, run the [List groups](https://techdocs.akamai.com/iam-api/reference/get-groups) operation. | |
users
|
string | (Optional) Returns users assigned to the roles, `false` by default. | |
ignoreContext
|
string | (Optional) Returns all the roles for the current account, ignoring the contract type of your API client, `false` by default. | |
accountSwitchKey
|
string | (Optional) For customers who manage more than one account, this [runs the operation from another account](https://techdocs.akamai.com/developer/docs/manage-many-accounts-with-one-api-client). The Identity and Access Management API provides a [list of available account switch keys](https://techdocs.akamai.com/iam-api/reference/get-client-account-switch-keys). |
HEADERS
| Key | Datatype | Required | Description |
Accept
|
string | Curl curl -X GET 'https://host/identity-management/v3/user-admin/roles?actions=&groupId=&users=&ignoreContext=&accountSwitchKey=' -H 'Accept: application/json' ENDPOINTS |