Swagger may be autogenerated, but if the internal structure of the app is crap then you still won't have a good time. I once encountered an API which managed to

Swagger may be autogenerated, but if the internal structure of the app is crap then you still won't have a good time. I once encountered an API which managed to have about a dozen (!) "Token" classes, all referred to as "token" in all responses but all slightly different. The docs (autogenerated, though not by swagger) helpfully informed me that "a Token is required for this request" on every request type without specifying which type of token.