These docs are for v2. Click to read the latest docs for v3.

Create a role

Create a custom role. 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.

Query Params
string

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.

Body Params

Specifies a new role.

grantedRoles
array of objects

A list of grantable role IDs.

grantedRoles
string
length between 1 and 250

A meaningful description for the role.

string
length between 1 and 70

The role's name.

Response

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json