ACT-1652: documented new REST-API methods