Get Permitted Roles
GET {{cb_url}}/access/v3/orgs/{{cb_org_key}}/principals/{{cb_custom_id}}/roles/permitted?type=USER
Returns a list of roles that may be managed by the user making the request. Helps to identify roles in an organization and its child organizations (in a multi-tenant environment).
Note: In order for this API call to function correctly, the {token} in the endpoint URL below must match the “token” portion of the API credentials specified in the X-Auth-Token header (everything after the ‘/’ character). Otherwise a 403 Forbidden error will be returned.
RBAC Permissions Required
See the Authentication section of these APIs for more information on what is required to authenticate these requests.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
type | string | USER or API_KEY |