Specifications and documentation for REST API endpoints

Summary
Specifications and documentation for REST APIendpoints