actually implemented the complete documented binary REST interface function