alex-astronomer opened a new issue #18713:
URL: https://github.com/apache/airflow/issues/18713
### Describe the issue with documentation
When using the `PATCH` verb for the `/roles/{role_name}` endpoint, I found
myself, as a beginner with the stable API, having to look through source code
and the meta database to try to find the correct terms to use for
`action.name`, `permissions.name` and other pieces that get merged into the
role with this command.
### How to solve the problem
I'd like to add some better documentation to the API `yml` that better
explains how to use this command. More details about the options for action
and permission and resource.
Thoughts? Maybe I'm missing something?
### Anything else
_No response_
### Are you willing to submit PR?
- [X] Yes I am willing to submit a PR!
### Code of Conduct
- [X] I agree to follow this project's [Code of
Conduct](https://github.com/apache/airflow/blob/main/CODE_OF_CONDUCT.md)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
