Moving detailed API specification

Will update the README.md with a summary of control flow.