:doc:`MailManager <../../mailmanager>` / Client / delete_archive

**************
delete_archive
**************



.. py:method:: MailManager.Client.delete_archive(**kwargs)

  

  Initiates deletion of an email archive. This changes the archive state to pending deletion. In this state, no new emails can be added, and existing archived emails become inaccessible (search, export, download). The archive and all of its contents will be permanently deleted 30 days after entering the pending deletion state, regardless of the configured retention period.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/mailmanager-2023-10-17/DeleteArchive>`_  


  **Request Syntax**
  ::

    response = client.delete_archive(
        ArchiveId='string'
    )
    
  :type ArchiveId: string
  :param ArchiveId: **[REQUIRED]** 

    The identifier of the archive to delete.

    

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {}
      
    **Response Structure**

    

    - *(dict) --* 

      The response indicating if the archive deletion was successfully initiated.

       

      On success, returns an HTTP 200 status code. On failure, returns an error message.

      
  
  **Exceptions**
  
  *   :py:class:`MailManager.Client.exceptions.ValidationException`

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

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

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

  