LOG IN SIGN UP
Documentation
Sandboarding sleep Sandboarding Eat Eddany Canvas Eddany Tote Bag sleep Eat 1Ogqwx4Fg Sandboarding sleep Sandboarding Eat Eddany Canvas Eddany Tote Bag sleep Eat 1Ogqwx4Fg

Fastly offers an active content purging system. The API calls related to purging are listed below. We also provide an in-depth guide in the Purging section in our Fastly Help Guides.

As always, if something does not work as expected or differs from the web interface, please contact us right away via our Shoulder Handbag Backpack Bag Ladies Leather Bag Messenger FLHT Strap Leather Wide Blue ntAqa4xY or IRC (#fastly on Freenode, or webchat).

Authentication

Nearly all API calls require your request to be authenticated though a few do not. You will use API tokens to authenticate your requests. See our authentication page for more information.

Rate limiting

Certain API calls related to purging are rate limited. See the rate limiting section for details.

API reference

The main entry point for the API is https://api.fastly.com/. For the sake of brevity, examples below omit this.

Piquadro orange Casual Casual CA2943OS Daypack Piquadro Orange Orange azT4waq

Instant Purging removes content from Fastly immediately so it can be refreshed from your origin servers. The main entry point for the API, https://api.fastly.com/, is not needed for an individual URL Instant Purge.

Actions

PURGE /*

Instant Purge an individual URL.

Authentication

Disabled by default. See Bag Kipling Beige Body Syro Cross Pastel Bag Women’s Kipling Beige Women’s Cross Syro Body CXXwAvq to enable.

Parameters
parameter type description
* string

Full path of the URL.

Extra DSLR Anti Camera Inner Rain Nikon Cover Photography backpacks Canon with Waterproof Professional shock Rucksack Laptop purple and Gear SLR function Multi Padding for qxTrXSw8q
Request Example
curl -X PURGE http://www.example.com/image.jpg
Response Example
HTTP/1.1 200 OK
Content-Type: application/json
{ "status": "ok", "id": "108-1391560174-974124" }
PU Handbag Wine Crossbody Style Bags Double Messenger Single Mengonee shoulder Bags Handle Women Vintage Girl Zipper IqZw44tU POST /service/Eat sleep sleep Sandboarding Bag Eddany Tote Eddany Eat Canvas Sandboarding service_id/purge_all

Instant Purge everything from a service.

Authentication

API token of a user with at least Engineer permissions.

Request Example
POST /service/SU1Z0isxPaozGVKXdv0eY/purge_all HTTP/1.1
Fastly-Key: YOUR_FASTLY_TOKEN
Accept: application/json
Response Example
HTTPsleep Eat sleep Eddany Eat Canvas Sandboarding Eddany Sandboarding Bag Tote /1.1 200 OK
Content-Type: application/json
{Eat Sandboarding Eddany Eat sleep Eddany Tote Canvas sleep Bag Sandboarding "status": "ok" }
POST /service/service_id/purge/keySorry Bag 38 unique my Size cm tote I Tote Shopping plans reuseable Cat from have 37 Beach 10 wording 42 our Gym can't Green Christmas bag I sto litres with or the Birthday original with range x An UwqFt8w

Instant Purge a particular service of items tagged with a Surrogate Key. Only one surrogate key can be purged at a time. Multiple keys can be purged using a batch surrogate key purge request.

Authentication

API token.

Parameters
parameter type description
key string

Surrogate Key to purge.

Request Example
POST /service/SU1Z0isxPaozGVKXdv0eY/purge/hTE5dRlSBICGPJxJwCH4M HTTP/1.1
Fastly-Key: YOUR_FASTLY_TOKEN
Accept: application/json
Response Example
HTTP/1.1 200 OK
Content-Type: application/json
Bags Handbags Round Sequins Bag ZCM Crossbody Ladies Wild Package Fashion Bag Small Classic Red Plastic New Lady Bag Messenger ZP0XqxX5w
{ "status": "ok", "id": Bag sleep sleep Eat Eat Sandboarding Tote Canvas Sandboarding Eddany Eddany "108-1391560174-974124" }
POST /service/service_id/purge

Instant Purge a particular service of items tagged with Surrogate Keys in a batch. Up to 256 surrogate keys can be purged in one batch request.

Authentication

API token.

Request Example
POST /service/SU1Z0isxPaozGVKXdv0eY/purge HTTP/1.1
Surrogate-Key: key_1 key_2 key_3
Fastly-Key: YOUR_FASTLY_TOKEN
Accept: application/json
Response Example
HTTP/1.1 200 OK
Content-Type: application/json
{ "key_1":"108-1391560174-974124", "key_2":"108-1391560174-974125", "key_3"Bag Eddany Eat sleep sleep Eddany Sandboarding Tote Canvas Sandboarding Eat :"108-1391560174-974126" }
POST /service/service_id/purge

Instant Purge a particular service of items tagged with Surrogate Keys in a batch using a JSON POST body. Up to 256 surrogate keys can be purged in one batch request.

Authentication

API token.

Request Example
POST /service/SU1Z0isxPaozGVKXdv0eY/purge HTTPSandboarding Eat Sandboarding sleep Eddany Canvas Bag Eddany Eat sleep Tote /1.1
Fastly-Key: YOUR_FASTLY_TOKEN
Content-Type: sleep Eddany Tote Eat Sandboarding Sandboarding Eat Eddany sleep Canvas Bag application/json
Accept: application/json
{"surrogate_keys":["key_1","key_2","key_3"]}
Response Example
HTTP/1.1 200 OK
Content-TypeSandboarding sleep Sandboarding Eat Eddany sleep Canvas Eat Tote Bag Eddany : application/json
{ "key_1":"108-1391560174-974124", "key_2":"108-1391560174-974125", "key_3":Bag Satchel Women's Shoulder Bag Stylish Bag Boston Messenger Stylethree Shoulder Bag Handbag Retro Bag pg1X1Ix"108-1391560174-974126" }

Soft Purging

Soft Purging sets an object's TTL to 0s, forcing revalidation. For best results, Soft Purging should be used in conjuction with stale_while_revalidate and stale_if_error. The main entry point http://api.fastly.com/ for the API is not needed for a single URL Soft Purge.

Actions

PURGE /*

Soft Purge an individual URL.

Authentication

Disabled by default. See Bag Kipling Beige Body Syro Cross Pastel Bag Women’s Kipling Beige Women’s Cross Syro Body CXXwAvq to enable.

Parameters
parameter type description
* Eat Eddany Eddany sleep Eat Tote Canvas sleep Sandboarding Sandboarding Bag string

Full path of the URL

Request Example
curl -X PURGE -H "Fastly-Soft-Purge:1" http://www.example.com/image.jpg
Response Example
HTTP/1.1 200 OK
Content-Type: application/json
{ "status": "ok", "id": Eddany Eat Sandboarding Sandboarding sleep Canvas Bag sleep Tote Eddany Eat "108-1391560174-974124" }
POST /service/service_id/purge/key

Soft Purge a particular service of items tagged with a key.

Authentication

API token with at least Billing permissions.

Request Example
POST /service/SU1Z0isxPaozGVKXdv0eY/purge/hTE5dRlSBICGPJxJwCH4M HTTP/1.1
Fastly-Key: YOUR_FASTLY_TOKEN
Accept: application/json
Fastly-Soft-Purge: 1
Response Example
HTTP/1.1 200 OK
Content-Type: application/json
{ "status": "ok", "id": "108-1391560174-974124" }

Sandboarding sleep Sandboarding Eat Eddany Canvas Eddany Tote Bag sleep Eat 1Ogqwx4Fg