doc: add admin api doc

When writing a document like this, it helps to make the conventions clear in an appendix. I'm specifically thinking of the `:id` piece in the URLs.