Skip to main content
Use this endpoint to permanently remove a file from your application’s filesystem. Supply the path to the file you want to delete and the API will remove it immediately. This operation is irreversible — ensure you have a backup or snapshot of the file before proceeding if you may need it later.

​
Endpoint

DELETE https://api.virtuscloud.app/v2/apps/{app_id}/files

​
Authorization

Include your API key in the request header: 
Authorization: <api_key>

​
Path Parameters

​
app_id
string
required
The unique identifier of your application. You can find this in the URL of your application’s dashboard.

​
Body Parameters

​
path
string
required
The path of the file to delete, relative to the root of your application. Example: /logs/app.log or /tmp/upload.tmp.

​
Response

​
status
string
Indicates the outcome of the request. Returns "success" when the file has been deleted successfully.

​
Examples

curl --request DELETE \
  --url "https://api.virtuscloud.app/v2/apps/{app_id}/files" \
  --header "Authorization: <api_key>" \
  --header "Content-Type: application/json" \
  --data '{
    "path": "/logs/app.log"
  }'

​
Response Example

{
  "status": "success"
}
File deletion is permanent and cannot be undone through the API. Consider creating a snapshot of your application before performing bulk deletions.