updated api docs for scaling and restart