docs: def requires_auth(f):
      """A decorator for flask api methods that validates auth0 tokens, hence ensuring
      that the user is authenticated. Code coped from:
      https://github.com/auth0/auth0-python/tree/master/examples/flask-api
      """
  
      @wraps(f)
      def requires_auth_decorator(*args, **kwargs):
  
          try:
              authenticate_http_request()
          except PyMacaronException as e:
              return e.http_reply()
  
          return f(*args, **kwargs)
  
      return requires_auth_decorator