This documentation is for WSO2 Private PaaS 4.1.0. View documentation for the latest release.
Page Comparison - Forcefully Undeploying an Application (v.2 vs v.3) - WSO2 Private PaaS 4.1.0 - WSO2 Documentation

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.

You can forcefully undeploy an application using the REST API or the Private PaaS console (UI) PPaaS Console as shown below:


Localtab Group

Forcefully undeploying an application via the REST API


Forcefully undeploy an application. This will remove the entire runtime of the specified application. Forceful termination can be invoked even without invoking graceful undeployment.

Resource Path


Request/Response Format


Command format
Code Block
curl -X POST -H "Content-Type: application/json" -k -v -u <USERNAME>:<PASSWORD> https://<PRIVATE_PAAS_HOST>:<PRIVATE_PAAS_HTTPS_PORT>/api/applications/{applicationId}/undeploy?force=true
  • By default, <USERNAME>:<PASSWORD> is admin:admin.
  • By default, <PRIVATE_PAAS_HOST> is localhost. However, if you are using a public IP, the respective IP address or domain needs to be specified.
  • By default, <PRIVATE_PAAS_HTTPS_PORT> has been set to 9443. However, if the port offset has been incremented by n, the default port value needs to be incremented by n.
  • The ID of the application in the application JSON file added previously needs to be defined as the {applicationId} value.

Forcefully undeploy the application named wso2am-190-application.

Code Block
curl -X POST -H "Content-Type: application/json" -k -v -u admin:admin https://localhost:9443/api/applications/wso2am-190-application/undeploy?force=true
Sample output
Code Block
> POST /api/applications/wso2am-190-application/undeploy?force=true HTTP/1.1
> Host: localhost:9443
> Authorization: Basic YWRtaW46YWRtaW4=
> User-Agent: curl/7.43.0
> Accept: */*
> Content-Type: application/json
< HTTP/1.1 202 Accepted
< Date: Mon, 12 Oct 2015 05:54:04 GMT
< Content-Type: application/json
< Transfer-Encoding: chunked
< Server: WSO2 Carbon Server
{"status":"success","message":"Application undeploy process started successfully: [application-id] wso2am-190-application"}

You will come across the following HTTP status codes while deleting an application:

HTTP status code

202, 500

See the descriptions of the HTTP status codes here.

titlePrivate PaaS consolePPaaS Console

Forcefully undeploying an application via

the Private PaaS console

the PPaaS Console

Follow the instructions below to forcefully undeploy an application:


You can forcefully undeploy an application if the application you are trying to undeploy continues to remain in the undeploy state and is not undeployed successfully via graceful undeployment.

  1. Click Application on the home page.
    Image Added
  2. Click View, if the application remains to be in the undeploying state after you click undeploy as instructed in Undeploying an Application. 
    Image Added
  3. Click Force Undeploy.
    Image Added
  4. Click Yes to forcefully undeploy the application.
    Image Added