POST /service/{service_id}/purge
Instant Purge a particular service of items tagged with surrogate keys. Up to 256 surrogate keys can be purged in one batch request. As an alternative to sending the keys in a JSON object in the body of the request, this endpoint also supports listing keys in a Surrogate-Key request header, e.g. Surrogate-Key: key_1 key_2 key_3.
Authorization: Requires API token.
Servers
- https://api.fastly.com
Path parameters
Name | Type | Required | Description |
---|---|---|---|
service_id |
String | Yes |
Request headers
Name | Type | Required | Description |
---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
fastly-soft-purge |
String | No | |
host |
String | No | |
surrogate-key |
String | No |
Request body fields
Name | Type | Required | Description |
---|---|---|---|
surrogate_keys[] |
Array | No |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.