Doc the return value for this method since it is now a deferred.  Also this should return a failure.