Added api documentation for the upcoming API, so i have something to design it from.