Purge Site Cache

POST

https://api.servebolt.io/v1/environments/{id}/purge_cache

Purge an site HTTP and CloudFlare cache by prefix, host, cache tag or file path.

It is important to note that Servebolt CDN users can only purge by Tags, or by Host. For full access to all types of purging, the website must be setup on the Accelerated Domains CDN.

Use only the correct CDN

Servebolt CDN and Accelerated Domains use different Zones inside Cloudflare, sending requests to the wrong zone will fail. Make sure to set the Type to be 'serveboltcdn' when on Servebolt CDN.

Add uniquness to your cache tags

To confirm uniqueness of the cache tags, make sure to use a prefix when adding them to HTTP headers on reponses, and again when requesting a purge. In the example the Environment ID has been used as a prefix. On Servebolt hosted services, the enviroment.json file can be found in the ~/ home of the SSH/FTP user on the server. In this file there is both the API bearer key and the Site ID.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Header Params

Body Params application/json

Example

{
    "files": ["https://example.com/image.jpg", "https://example.com/article/about-caching", "https://example.com/"],
    "prefixes" : ["https://example.com/static/files/", "https://example.com/product/release/micro-site/"],
    "hosts" : ["staging.example.com", "acceptance.example.com"],
    "tags" : ["1234-home", "1234-post-archive", "1234-term-caching" , "1234-term-performance"]    
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.servebolt.io/v1/environments/1234/purge_cache' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer 2f68dbbf-519d-4f01-9636-e2421b68f379' \
--header 'Content-Type: application/json' \
--data-raw '{
    "files": ["https://example.com/image.jpg", "https://example.com/article/about-caching", "https://example.com/"],
    "prefixes" : ["https://example.com/static/files/", "https://example.com/product/release/micro-site/"],
    "hosts" : ["staging.example.com", "acceptance.example.com"],
    "tags" : ["1234-home", "1234-post-archive", "1234-term-caching" , "1234-term-performance"]    
}'

Responses

🟢200Success

application/json

Body

Example

{}

Modified at 2025-06-25 09:03:05

Delete Site

List Site Cronjobs