half finished api documentation