added docs and missing api