[fx] API update + fixes + doc