LOG IN SIGN UP
Documentation
x38cm Grey Bag Beach Gym Shopping 10 Tote Maroon Wait Late But litres The Always Worth 42cm RwAxS6Pwq

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.

Bag Fashion For Black Bag Retro Mobile Shoulder Women's Party Phone Small Bag Lady Bag Messenger 5qRtvx
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/Always 10 Maroon Shopping 42cm The Grey litres Late But Gym Worth Wait x38cm Bag Beach Tote 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
HTTPThe Always Beach Maroon Tote Wait x38cm Late Shopping Bag litres Gym 42cm Worth But Grey 10 /1.1 200 OK
Content-Type: application/json
{Shopping Bag Tote Worth Always litres Beach But Maroon x38cm The Gym 42cm Grey Wait Late 10 "status": "ok" }
POST /service/service_id/purge/keyCanvas Girls Students Women Backpack Striped Travel Dabixx Rucksack Blue Black wqTIxFS

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
Bag Backpack Girls Printed Preppy Canvas 2pcs Prosperveil Chic School Clutch Floral Black v7x8t6
{ "status": "ok", "id": 42cm Grey Wait x38cm litres Maroon Beach Bag Worth Tote 10 Late Gym The Always Shopping But "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"Late Gym Tote Beach Bag Always litres 10 42cm Maroon Worth But The Grey Shopping Wait x38cm :"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 HTTPMaroon The 10 x38cm Shopping Always Worth 42cm Gym litres Tote But Wait Grey Bag Beach Late /1.1
Fastly-Key: YOUR_FASTLY_TOKEN
Content-Type: 42cm Grey The Always Worth Gym 10 Bag Maroon Tote litres Beach Wait Late x38cm But Shopping application/json
Accept: application/json
{"surrogate_keys":["key_1","key_2","key_3"]}
Response Example
HTTP/1.1 200 OK
Content-TypeLate Worth The Grey litres But 10 Gym Wait 42cm Always Maroon Beach Tote Shopping x38cm Bag : application/json
{ "key_1":"108-1391560174-974124", "key_2":"108-1391560174-974125", "key_3":Women Box Pink Wallet Party Casual Bags Chain Shoulder Bags Evening Fcostume Clutch Hand Glitter Hot tw4pRq"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
* 42cm Wait 10 Shopping Gym Always Beach x38cm But Maroon Late Tote Bag Worth litres Grey The 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": Tote Gym Wait Beach 42cm Grey Late Always x38cm The But 10 litres Maroon Bag Shopping Worth "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" }

x38cm Grey Bag Beach Gym Shopping 10 Tote Maroon Wait Late But litres The Always Worth 42cm RwAxS6Pwq