Skip to main content
POST
Assign a role to a user

Authorizations

Authorization
string
header
required

JWT Bearer token authentication

Path Parameters

accountId
string
required

The account identifier (external account ID)

Example:

"my-company-account"

Body

application/json
assigneeId
string
required

Assignee identifier (external user/group ID)

Example:

"john.doe"

assigneeType
enum<string>
required

The type of assignee

Available options:
USER,
IAMGROUP
roleId
string
required

Role identifier to assign

Example:

"project_admin"

projectId
string

Project identifier (required for PROJECT scoped roles, must be empty for ACCOUNT scoped roles)

Example:

"project-alpha"

Response

Role successfully assigned

assigneeId
string
required

Assignee identifier (external user/group ID)

Example:

"jane.smith"

assigneeType
enum<string>
required

The type of assignee

Available options:
USER,
IAMGROUP
roleId
string
required

Role identifier

Example:

"account_admin"

status
enum<string>
required

The status of the role assignment

Available options:
ACTIVE,
INACTIVE
createdAt
string<date-time>
required
updatedAt
string<date-time>
required