Today I was working with the API and discovered a couple of useful resources.
This shows (the entire?) api: discourse_api/routes.txt at master · discourse/discourse_api · GitHub
If you can do something interactively but don’t know how to do it with the API just go to Chrome, go to More Tools > Developer Tools, and you can see all the API calls that application makes in order to do the function you just did interactively.
I wonder if there are other non-obvious ways to learn more about the API? Unfortunately I am mostly Ruby illiterate (we Python people think that Ruby is a four letter word) so looking at Ruby code might not be very enlightening to me.