#488 Updated api docs to make clear the difference between apiv1 and apiv2 so that docs are ready for beta phase dpeloy