Thank you for posting in the Tableau Community Forums. This is a great place to get feedback on things like use of the TSM API. Creating an idea is one of the best ways to get this in front of the Tableau Product Managers.
We have an excellent write up on how to write an idea as well: How to write an idea Tableau Program Managers will look at
I would encourage you to share the idea with channels and groups of other Tableau wizards for the more votes the more likely it will get included in a future release!