:doc:`ElasticBeanstalk <../../elasticbeanstalk>` / Client / delete_application

******************
delete_application
******************



.. py:method:: ElasticBeanstalk.Client.delete_application(**kwargs)

  

  Deletes the specified application along with all associated versions and configurations. The application versions will not be deleted from your Amazon S3 bucket.

   

  .. note::

    

    You cannot delete an application that has a running environment.

    

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/elasticbeanstalk-2010-12-01/DeleteApplication>`_  


  **Request Syntax**
  ::

    response = client.delete_application(
        ApplicationName='string',
        TerminateEnvByForce=True|False
    )
    
  :type ApplicationName: string
  :param ApplicationName: **[REQUIRED]** 

    The name of the application to delete.

    

  
  :type TerminateEnvByForce: boolean
  :param TerminateEnvByForce: 

    When set to true, running environments will be terminated before deleting the application.

    

  
  
  :returns: None
  **Exceptions**
  
  *   :py:class:`ElasticBeanstalk.Client.exceptions.OperationInProgressException`

  

  **Examples**

  The following operation deletes an application named my-app:
  ::

    response = client.delete_application(
        ApplicationName='my-app',
    )
    
    print(response)

  
  Expected Output:
  ::

    {
        'ResponseMetadata': {
            '...': '...',
        },
    }

  