rest implemented and doc updated with usage