Error purging Fastly cache on Cloud (The purge request was not processed successfully)

This article provides a fix for when you use a Fastly purge option, and you receive the error: The purge request was not processed successfully. Fastly is a CDN and caching service included with Adobe Commerce on cloud infrastructure plans and implementations. If you attempt to use a Fastly purge option, and it does not process, you may have incorrect Fastly credentials in your environment or may have encountered an issue.

This information helps you verify and test Fastly headers for your live site and origin servers.

Affected versions

Adobe Commerce on cloud infrastructure 2.1.X and later
Fastly 1.2.27 and later

Issue

Caching is working, but when you try to purge, you receive an error or it doesn't work. The error includes: "The purge request was not processed successfully."

Cause

You may have incorrect credentials set in your environment or need to upload VCL snippets.

Resolve

Check Fastly credentials

Verify if you have the correct Fastly Service ID and API token in your environment. If you have Staging credentials in Production, the purges may not process or process incorrectly.

Log in to your local Commerce Admin as an administrator.
Click Stores > Settings > Configuration > Advanced > System and expand Full Page Cache.
Expand Fastly Configuration and verify the Fastly Service ID and API token for your environment.
If you modify the values, click Test Credentials.

Check VCL snippets

If the credentials are correct, you may have issues with your VCLs. To list and review your VCLs per service, enter the following API call in a terminal:

curl -X GET -s https://api.fastly.com/service/<Service ID>/version/<Editable Version #>/snippet -H "Fastly-Key:FASTLY_API_TOKEN"

Review the list of VCLs. If you have issues with the default VCLs from Fastly, you can upload again or verify the content per the Fastly default VCLs. For editing your custom VCLs, see Custom Fastly VCL snippets in the Commerce on Cloud Infrastructure Guide.

More information

In our developer documentation: