#NEWLINE# def send_shared_pin( self , topics , pin , skip_validation = False ) : #NEWLINE# #INDENT# '\n        Send a shared pin for the given topics.\n\n        :param list topics: The list of topics.\n        :param dict pin: The pin.\n        :param bool skip_validation: Whether to skip the validation.\n        :raises pypebbleapi.schemas.DocumentError: If the validation process failed.\n        :raises `requests.exceptions.HTTPError`: If an HTTP error occurred.\n        ' #NEWLINE# if ( not self . api_key ) : #NEWLINE# #INDENT# raise ValueError ( 'You need to specify an api_key.' ) #NEWLINE# #UNINDENT# if ( not skip_validation ) : #NEWLINE# #INDENT# validate_pin ( pin ) #NEWLINE# #UNINDENT# response = _request ( 'PUT' , url = self . url_v1 ( ( '/shared/pins/' + pin [ 'id' ] ) ) , user_agent = self . user_agent , api_key = self . api_key , topics_list = topics , json = pin ) #NEWLINE# _raise_for_status ( response )