maybe I should not be reading swagger docs anymore...