finish show action and update the api doc