BBL-679 updated api documentation