Update api/endpoints documentation

[karenmajewicz]

• Check for new endpoints created since last update
• investigate plugins to automatically document these using Swagger's UI
• consider a different structure or new page that would describe the uses of each endpoint in a less technical format