POST
/
v1
/
apps
/
{app_id}
/
network
/
purge-cache
Network Purge Cache
curl --request POST \
  --url https://api.vertracloud.app/v1/apps/{app_id}/network/purge-cache \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "paths": [
    {}
  ]
}'
{
  "status": "success"
}
​
app_id
string
required
The ID of the application to purge the cache for.
​
paths
array
An optional array of URL paths to purge (e.g., ["https://example.com/path1", "https://example.com/path2"]). If not provided, the cache for all paths under the application’s subdomain or custom domain is purged.

​
Response

​
status
string
Indicates whether the call was successful. success if successful, error if not.
{
  "status": "success"
}

​
Error Responses

​
status
string
Indicates whether the call was successful. error if not successful.
​
code
string
The error code indicating the reason for failure. Possible values:
  • UNAUTHORIZED: The user is not authenticated or lacks sufficient permissions.
  • UNAUTHORIZED_APP: The specified application does not exist or does not belong to the user.
  • NO_AUTHORIZED_PATHS: None of the provided paths are valid or belong to the application’s subdomain or custom domain.
  • PURGE_FAILED: The cache purge operation failed.
{
  "status": "error",
  "code": "UNAUTHORIZED"
}