Skip to main content
PUT
/
api
/
v1
/
accounts
/
{accountId}
/
roles
/
{roleId}
/
assignments
/
{assigneeId}
Update role assignment for a user
curl --request PUT \
  --url https://api.aion.xyz/api/v1/accounts/{accountId}/roles/{roleId}/assignments/{assigneeId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "assigneeType": "USER",
  "roleId": "project_reader",
  "projectId": "project-beta",
  "status": "ACTIVE"
}
'
{
  "assigneeId": "jane.smith",
  "assigneeType": "USER",
  "roleId": "account_admin",
  "status": "ACTIVE",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

JWT Bearer token authentication

Path Parameters

​
accountId
string
required

The account identifier (external account ID)

Example:

"my-company-account"

​
roleId
string
required

The new role identifier to assign

Example:

"project_admin"

​
assigneeId
string
required

The assignee identifier (external user ID)

Example:

"john.doe"

Query Parameters

​
projectId
string

Project identifier for project-scoped role assignments

Example:

"project-alpha"

Body

application/json
​
assigneeType
enum<string>
required

The type of assignee

Available options:
USER,
IAMGROUP
​
roleId
string
required

The current role identifier being replaced

Example:

"project_reader"

​
projectId
string

Project identifier (for project-scoped roles)

Example:

"project-beta"

​
status
enum<string>

The status of the role assignment

Available options:
ACTIVE,
INACTIVE

Response

Role assignment successfully updated

​
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