Skip to main content
Use this endpoint to gracefully shut down a running application. Virtus Cloud sends a termination signal to the process and waits for it to exit cleanly. Stopping an application frees the RAM and CPU allocated to it while preserving all deployed files and configuration on the server — you can restart the application at any time with the Start endpoint.
Stopping an application immediately terminates all active connections and in-flight requests. Ensure your application saves any persistent state before shutdown, or implement graceful shutdown handling within your process.

​
Endpoint

POST https://api.virtuscloud.app/v2/apps/{app_id}/stop

​
Path parameters

​
app_id
string
required
The unique ID of the application. You can find this in the URL of your application’s dashboard page on Virtus Cloud.

​
Request headers

​
Authorization
string
required
Your Virtus Cloud API key. See Authentication for details.

​
Response

​
status
string
Indicates whether the request succeeded. Returns "success" when the stop command is accepted and the application process is being terminated.

​
Code example

curl --request POST \
  --url https://api.virtuscloud.app/v2/apps/<app_id>/stop \
  --header "Authorization: <your_api_key>"

​
Response example

{
  "status": "success"
}