Logo
Akamai APIs API Documentation

Get a role

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

This operation retrieves a role's details.

 

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.
grantedRoles
string (Optional) Lists granted roles assigned for a role, `false` by default.
users
string (Optional) Returns users assigned to the roles, `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




RESPONSES

status OK

Curl
curl -X GET 'https://host/identity-management/v3/user-admin/roles/:roleId?actions=&grantedRoles=&users=&accountSwitchKey=' -H 'Accept: application/json'

ENDPOINTS