Baton has an open API definition for all of its endpoints here. We should trigger an action in CI (weekly/ bi-weekly?) that gets the json data and modifies the appropriate files in the repo then submits a bot PR for review so we can keep the schemas current with minimal manual touch.