Bulk update board roles for users and teams

Two new mutations let you set the role of many users or teams on a board in a single call: update_users_board_role and update_teams_board_role. Both require the boards:write scope.

• update_users_board_role takes a board_id, a role_name and up to 200 user_ids.
• update_teams_board_role takes a board_id, a role_name and up to 50 team_ids.

The users and teams must already be subscribed to the board. These mutations change a role, they don't grant board access. To subscribe them first, use add_users_to_board or add_teams_to_board.

role_name is a BoardBasicRoleName value: editor (can edit the board structure and content), contributor (can edit content only) or viewer (read-only access). update_users_board_role also accepts member (the default board role) for agent users only, and update_teams_board_role doesn't accept it. assigned_contributor is not supported yet.

Each mutation returns the outcome per ID. UpdateUsersBoardRoleResponse and UpdateTeamsBoardRoleResponse list the IDs that were updated (successful_user_ids or successful_team_ids) and a list of failures (failed_users or failed_teams), each with the ID and an error message. Check the failure list after every call.

mutation {
  update_users_board_role(
    board_id: 1234567890
    user_ids: [111, 222]
    role_name: viewer
  ) {
    successful_user_ids
    failed_users {
      user_id
      error
    }
  }
}

See Update users board role and Update teams board role in the Boards reference for the full argument and field tables.