updated users api spec
update fn doc