Skip to main content

updateAccountUsers

Updates the role and site access of members or pending invitations and returns their roster rows in the order of ids. Send role, specificSites, and sites on every call: omitting specificSites resets access to all sites. Owners always have access to all sites. Requires team settings edit access.

updateAccountUsers(
  ids: [String!]!
  role: AccountUsersRole
  sites: [String]
  specificSites: Boolean
): [AccountTeamMember!]!

Arguments​

updateAccountUsers.ids ● [String!]! non-null scalar​

Member (ua_) or invitation (i_) IDs from accountUsers whose canUpdate is true.

updateAccountUsers.role ● AccountUsersRole enum​

Role to assign; send it on every call, even when unchanged. ACCOUNT_HOLDER is treated as OWNER without transferring account ownership.

updateAccountUsers.sites ● [String] list scalar​

Site names from sites, not numeric IDs; must be nonempty when specificSites is true. Owners ignore this list.

updateAccountUsers.specificSites ● Boolean scalar​

Whether to restrict access to the listed sites; false, null, or omitted resets access to all sites. Ignored for owners.

Type​

AccountTeamMember object​

A roster row from accountUsers or team mutations representing the holder, a linked member, or an invitation. IDs are prefixed by record kind and unrestricted members expose an empty sites list.