Skip to main content
Use this endpoint to gracefully stop and restart an application without modifying its deployed files or configuration. A restart is useful when you need to apply updated environment variables, clear in-memory state, or recover from a process that has become unresponsive. Virtus Cloud terminates the current process and starts it again using the same files already on the server.
There will be a brief interruption in service while the application process restarts. If your application serves live traffic, plan restarts during low-traffic windows or implement client-side retry logic.

​
Endpoint

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

​
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 restart command is accepted and the application is cycling.

​
Code example

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

​
Response example

{
  "status": "success"
}