add examples and descriptions, missing filters for abuses in openapi spec