Skip to main content

Update user authorizations

PUT 
/user-grants/:user_id/authorizations/

Update User Authorizations.

This endpoint updates a user's authorizations by assigning a new role. It fetches the user from the authenticated client's organization and updates their project roles accordingly.

Path Parameters:​

  • user_id (required): The unique identifier of the user whose authorizations are updated.

Request Body:​

  • role (required): A role to assign to the user. Must be one of:
  • org:admin
  • org:staff
  • org:user

Response:​

  • 200 OK: Returns the updated list of user roles.
  • 404 Not Found: If the user is not found in the authenticated organization.

🔒 Authentication​

This endpoint require a valid OAuth2 Bearer

It supports account impersonation within Organization's sub-accounts using X-Eaz-Account-Id Header.

  • If the X-Eaz-Account-Id header is provided and the user has access rights to that sub-account, the impersonation context is applied.
  • Otherwise, the user's own account context is used.

Scopes :​

User must provide one of the following scopes:

  • admin
  • staff
  • user
  • org:admin
  • organization:write

Request​

Responses​

Successful Response