update api doc and convert params to numbers