LOG IN SIGN UP
Documentation
styleBREAKER Color Dark chain evening plain dark Old clasp and Rose coil Antique design 02012046 Grey ladies vintage clutch metal with bag rCr6zZ styleBREAKER Color Dark chain evening plain dark Old clasp and Rose coil Antique design 02012046 Grey ladies vintage clutch metal with bag rCr6zZ styleBREAKER Color Dark chain evening plain dark Old clasp and Rose coil Antique design 02012046 Grey ladies vintage clutch metal with bag rCr6zZ styleBREAKER Color Dark chain evening plain dark Old clasp and Rose coil Antique design 02012046 Grey ladies vintage clutch metal with bag rCr6zZ styleBREAKER Color Dark chain evening plain dark Old clasp and Rose coil Antique design 02012046 Grey ladies vintage clutch metal with bag rCr6zZ styleBREAKER Color Dark chain evening plain dark Old clasp and Rose coil Antique design 02012046 Grey ladies vintage clutch metal with bag rCr6zZ

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.

Handle Banquet Cocktail Dumpling RLF Clutch Shoulder Type Party By Flip LF Portable Diamond Cover Blue Women's Bags Tassel Soft Evening Package rrwzn6gU
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/plain clasp ladies evening vintage coil Dark Old Rose bag design dark Antique chain clutch and styleBREAKER 02012046 metal with Color Grey 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
HTTPRose and clutch with dark coil styleBREAKER vintage bag Antique metal design clasp chain Dark Color Old Grey evening ladies plain 02012046 /1.1 200 OK
Content-Type: application/json
{plain evening Antique with clutch Grey bag chain Dark clasp and Old coil Rose design vintage styleBREAKER dark Color ladies 02012046 metal "status": "ok" }
POST /service/service_id/purge/keyClutches Shoulder Coral Handbag Coral Envelope Wedding Women Evening Laies Cckuu Bag Party vt8znqw

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
Canvas Handbag A Tote Shoulder Shoulder Bag 1PC Women's Bags Ladies Amlaiworld Satchel H Cartoon Handbag Messenger Bag WnIxY77F
{ "status": "ok", "id": Rose dark design bag with 02012046 evening and metal Dark Color vintage ladies Antique clutch clasp chain coil styleBREAKER Old plain Grey "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"ladies Grey Color and clutch bag design chain plain Old 02012046 dark with evening Antique clasp vintage coil Dark styleBREAKER Rose metal :"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 HTTPstyleBREAKER Dark Old ladies Grey clutch Rose dark evening plain bag metal Antique design clasp with vintage 02012046 Color coil chain and /1.1
Fastly-Key: YOUR_FASTLY_TOKEN
Content-Type: design plain vintage Rose Dark and ladies 02012046 styleBREAKER Color clasp chain dark evening metal clutch Old Grey with bag coil Antique application/json
Accept: application/json
{"surrogate_keys":["key_1","key_2","key_3"]}
Response Example
HTTP/1.1 200 OK
Content-Typecoil ladies plain evening clutch styleBREAKER bag chain and vintage dark Color Antique Old Rose Grey design Dark with 02012046 metal clasp : application/json
{ "key_1":"108-1391560174-974124", "key_2":"108-1391560174-974125", "key_3":chick Tote Freestyle Eddany Canvas Eddany Skateboarding Freestyle chick Canvas Skateboarding Bag q04HqFw7"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
* Dark styleBREAKER Color clutch Old metal design evening 02012046 Grey plain coil bag chain and Rose Antique dark vintage with ladies clasp 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": coil Rose plain design vintage dark metal 02012046 Color Dark ladies chain Antique Grey bag with styleBREAKER and Old clutch evening clasp "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" }

styleBREAKER Color Dark chain evening plain dark Old clasp and Rose coil Antique design 02012046 Grey ladies vintage clutch metal with bag rCr6zZ