Permission Annotations in Swagger

Is your feature request related to a problem? Please describe. I am trying to write scripts using the API v2.0 and a Robot account, but I keep getting 403 Forbidden responses.

Describe the solution you'd like It would be helpful if in the Swagger file, you could identify "Permissions required: System-wide Project/List, Project-level Project/Read"

Describe the main design/architecture of your solution

Describe the development plan you've considered While this may introduce a mild security risk ("I have permission to do X, therefore, I could also do Y"), it may help developers to identify where additional permission controls should be placed.