Update openapi.yml

[jidanni]

In https://meta.discourse.org/t/allow-api-use-by-regular-users-not-just-admins/254724/ regular user Dan Jacobson lost hope thinking that only admins could make use of the API.

[oblakeerickson]

I like the idea of this, and I'd be open to updating the wording. However, without support from admins and an approved endpoint in the user api keys site settings "regular users" still can't just generate their own api keys.

I'm going to close this though as any change to the api docs actually needs to be in the discourse/discourse repo. From the README:

Please do not manually edit the openapi.yml or openapi.json files located in this repo. These files must be edited from the rswag files located in

https://github.com/discourse/discourse/tree/main/spec/requests/api

Text changes can be applied to this file: https://github.com/discourse/discourse/blob/main/spec/swagger_helper.rb

[jidanni]

OK. I didn't want to link to faraway URLs anyway. I'll drop the issue.
P. S., all I know is a GitHub search brought me to that file, that I wish had a 'do not edit' warning right there in the header.

[jidanni]

https://meta.discourse.org/t/allow-api-use-by-regular-users-not-just-admins/254724/6 has some more info on what maybe should get written. All this is over in my head of course so I'll just kind of step out here.