new apis documented