update api docs to match reality