A kind of documentation for standard interaction patterns should be added. Something like sequence diagrams could work.
This documentation should show what the workflow looks like for common processes such as:
- Endpoint usage by the UI
- Direct endpoint usage by a human over the API
- Usage of the batch endpoints
- etc.