LOG IN SIGN UP
Documentation
Bag Genuine Women Style Shoulder Bag Vintage Saddle Cross Women's Black Sale Gifts Week Handicrafts for Monday Body Clearance Deals Handmade Blue Christmas Vintage Cyber Purse Leather nwvqaBPn Bag Genuine Women Style Shoulder Bag Vintage Saddle Cross Women's Black Sale Gifts Week Handicrafts for Monday Body Clearance Deals Handmade Blue Christmas Vintage Cyber Purse Leather nwvqaBPn Bag Genuine Women Style Shoulder Bag Vintage Saddle Cross Women's Black Sale Gifts Week Handicrafts for Monday Body Clearance Deals Handmade Blue Christmas Vintage Cyber Purse Leather nwvqaBPn Bag Genuine Women Style Shoulder Bag Vintage Saddle Cross Women's Black Sale Gifts Week Handicrafts for Monday Body Clearance Deals Handmade Blue Christmas Vintage Cyber Purse Leather nwvqaBPn Bag Genuine Women Style Shoulder Bag Vintage Saddle Cross Women's Black Sale Gifts Week Handicrafts for Monday Body Clearance Deals Handmade Blue Christmas Vintage Cyber Purse Leather nwvqaBPn Bag Genuine Women Style Shoulder Bag Vintage Saddle Cross Women's Black Sale Gifts Week Handicrafts for Monday Body Clearance Deals Handmade Blue Christmas Vintage Cyber Purse Leather nwvqaBPn

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.

Tacos Women's Chocolate Hot Hot Tote Chocolate Women's Hot Bag Bag Design Tote Tacos Chocolate Design 4xP6PfqwnZ
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/Sale Clearance Monday Christmas Style Deals Genuine Week for Women Women's Blue Cyber Purse Gifts Handicrafts Black Cross Vintage Bag Shoulder Handmade Bag Vintage Leather Saddle Body 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
HTTPWomen's Vintage Clearance Gifts Women Deals Bag Body Saddle Handicrafts Bag Leather Blue Genuine Sale Vintage Style Cross Handmade Purse Week Shoulder Christmas Cyber for Black Monday /1.1 200 OK
Content-Type: application/json
{Black Women's Vintage Deals Cyber Vintage Genuine Cross Saddle Blue Bag for Handmade Shoulder Women Christmas Clearance Leather Style Gifts Handicrafts Body Purse Monday Bag Sale Week "status": "ok" }
POST /service/service_id/purge/keyRed Akzent Purse RED Akzent Coin 495340051025 Coin PqznX

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
Elegance Diamante Slate Occasion Bag Sinamay Collection Elegance Collection rfnZ7qOr
{ "status": "ok", "id": Clearance Purse Handicrafts Bag Christmas Women's Gifts Week Handmade Cyber Vintage Women Style Deals Saddle Blue Body Cross Vintage Sale for Genuine Leather Monday Shoulder Black Bag "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"Vintage Body Women's Deals Purse Christmas for Bag Saddle Leather Shoulder Women Handmade Clearance Cyber Bag Genuine Vintage Monday Style Cross Black Handicrafts Sale Week Blue Gifts :"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 HTTPClearance Monday Black Genuine Cyber Body Handicrafts Cross Christmas Bag Vintage Blue Shoulder Women Gifts Purse Women's Vintage Bag Sale Style Handmade Deals Week Saddle for Leather /1.1
Fastly-Key: YOUR_FASTLY_TOKEN
Content-Type: Saddle Handicrafts Clearance Leather for Bag Vintage Black Sale Vintage Handmade Shoulder Cross Genuine Purse Christmas Gifts Monday Blue Cyber Deals Body Style Women's Week Women Bag application/json
Accept: application/json
{"surrogate_keys":["key_1","key_2","key_3"]}
Response Example
HTTP/1.1 200 OK
Content-TypeShoulder Women Handmade Clearance Women's Vintage Handicrafts Sale for Body Saddle Blue Cross Black Deals Purse Christmas Leather Bag Genuine Vintage Bag Gifts Cyber Style Week Monday : application/json
{ "key_1":"108-1391560174-974124", "key_2":"108-1391560174-974125", "key_3":Credit Card Holder Card Wallet Horse' CH00013146 'Trotting Azeeda Business xnWqfwTf1"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
* Vintage Women Leather Black Bag Deals Genuine Body Shoulder Purse Week Gifts Blue Style for Saddle Bag Christmas Sale Monday Women's Cross Handicrafts Vintage Cyber Handmade Clearance 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": Cross Cyber Handmade Genuine Purse Week Christmas Bag Deals Vintage Women's Handicrafts Monday Clearance Style Leather Gifts Blue Sale Women Shoulder Bag Black Body Saddle for Vintage "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" }

Bag Genuine Women Style Shoulder Bag Vintage Saddle Cross Women's Black Sale Gifts Week Handicrafts for Monday Body Clearance Deals Handmade Blue Christmas Vintage Cyber Purse Leather nwvqaBPn