You could basically document any attribute you have decorated your actions with, but this will focus mainly on documenting the role part of the Authorize attribute.
When using roles based authentication I like to document the roles in my swagger spec, this gives a nice indication, to the consumer, of which roles are required for different endpoints.
Here I have a basic Authorize attribute with a required role of “Admin”.
As with most other things swashbuckle related, we need to create an IOperationFilter
And that is it, you have now auto documented every role required across your API.
The swagger docs will look like the following.
Documenting roles with swashbuckle
How to document attribute usage with swagger