API documentation update for milestones

Updated the milestones API documentation and added return codes descriptions.