update_organization_members_role

imerit_ango.sdk.SDK.

update_organization_members_role(organization_id, role_updates)

Change the roles of specified members in your organization.

Parameters

• organization_id: string

  • The unique identifier for the organization. You can find the organization ID in the user interface.

• role_updates: List[RoleUpdate]

  • A list of role updates for the members. Each RoleUpdate object contains the following attributes:

  • RoleUpdate

    • email: string

      • The email address of the member whose role is to be updated.

      • Example: "[email protected]"

    • organization_role: OrganizationRoles

      • The new role assigned to the member within the organization. Options include:

        • OrganizationRoles.Member

        • OrganizationRoles.Admin

from imerit_ango.models.invite import RoleUpdate
from imerit_ango.models.enums import OrganizationRoles

Returns:

• output: dict

  • A dictionary containing the result of the operation.

  • Including a status field indicating whether the request was successful and a data field containing the response payload with updated resources produced by the operation.

The email addresses provided in role_updates must belong to existing organization members.

How to verify in Ango Hub?

After successfully executing the update_organization_members_role function, you can validate the changes directly in Ango Hub.

Navigate to: Organization → Members

• Confirm that the invited members appear in the list under the invitations.

• Ensure that each user has been invited with the correct role assigned

Changes made via the SDK are reflected in Ango Hub in near real-time. If updates are not immediately visible, please refresh the page.

Example

python

import os
from dotenv import load_dotenv
from imerit_ango.sdk import SDK
from imerit_ango.models.invite import RoleUpdate
from imerit_ango.models.enums import OrganizationRoles

load_dotenv('variables.env')
api_key = os.getenv('API_KEY')
organization_id = os.getenv('ORGANIZATION_ID')

ango_sdk = SDK(api_key)

role_update_1 = RoleUpdate(email="[email protected]", organization_role=OrganizationRoles.Admin)
role_update_2 = RoleUpdate(email="[email protected]", organization_role=OrganizationRoles.Admin)

sdk_response = ango_sdk.update_organization_members_role(
    organization_id=organization_id,
    role_updates=[role_update_1, role_update_2]
)

curl

See also

get_organization_members, delete_organization_members