Document endpoint auth methods

[andrii-balitskyi]

Closes #447

[DebbieAtSeam]

@andrii-balitskyi I'm not sure about the placement and formatting of the note. I think it's important information, but is there a way to present the info. that's not in a hint box? Something like this maybe (but prettier)?

[andrii-balitskyi]

@DebbieAtSeam sure, but wasn't able to make it look prettier with the current setup. @razor-x any ideas on how to make it look better?

Here's how the section currently looks like:

[DebbieAtSeam]

@andrii-balitskyi I do like that ul better than the hint box, with the exception of the capitalization. Could you please explain a bit more about why users need this info.? For example, why do only some methods accept a client session token? Also, if the ul takes up too much space, you could try it as a plain comma-separated list in a p. Thanks!

[razor-x]

@DebbieAtSeam There are past examples (which I cannot post here) where having this information would have been very helpful to address customer and internal question.

[DebbieAtSeam]

@andrii-balitskyi Is there an importance or other logical order to the way in which the auth methods get listed in the bulleted lists? If not, is there a way to display them in alpha order? If not, it's nbd. Thanks!

[DebbieAtSeam]

Thanks, @andrii-balitskyi!