:doc:`VoiceID <../../voice-id>` / Client / delete_watchlist

****************
delete_watchlist
****************



.. py:method:: VoiceID.Client.delete_watchlist(**kwargs)

  

  Deletes the specified watchlist from Voice ID. This API throws an exception when there are fraudsters in the watchlist that you are trying to delete. You must delete the fraudsters, and then delete the watchlist. Every domain has a default watchlist which cannot be deleted.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/voice-id-2021-09-27/DeleteWatchlist>`_  


  **Request Syntax**
  ::

    response = client.delete_watchlist(
        DomainId='string',
        WatchlistId='string'
    )
    
  :type DomainId: string
  :param DomainId: **[REQUIRED]** 

    The identifier of the domain that contains the watchlist.

    

  
  :type WatchlistId: string
  :param WatchlistId: **[REQUIRED]** 

    The identifier of the watchlist to be deleted.

    

  
  
  :returns: None
  **Exceptions**
  
  *   :py:class:`VoiceID.Client.exceptions.ResourceNotFoundException`

  
  *   :py:class:`VoiceID.Client.exceptions.ValidationException`

  
  *   :py:class:`VoiceID.Client.exceptions.ConflictException`

  
  *   :py:class:`VoiceID.Client.exceptions.InternalServerException`

  
  *   :py:class:`VoiceID.Client.exceptions.ThrottlingException`

  
  *   :py:class:`VoiceID.Client.exceptions.AccessDeniedException`

  