updated api documentation