* repair structural problems with the openapi spec * additional tweaks to fix failing tests * un-mark is_categorized as required & restore method
Adding some api documentation for the badge routes.