new api documented.