Akamai image purge must include the query string and both pristine and derivative URLs

TL;DR

Context: Official docs (Akamai, purging images): with preserve-query-args enabled, query parameters are part of the URL portion of the cache key, so the purge URL must include the exact query string or it misses the object.

Steps

1. Purge the full URL including query string when preserve-query-args is on. If Origin Base Path is in your Image and Video Manager rules, submit two purge URLs per image: the normal one for the derivative and the same URL with ?imbypass=true for the pristine version. When purging by CP code, purge pristine images before derivatives.

When to use

You are seeing this: Purge the full URL including query string when preserve-query-args is on. Use this skill when you run into "Akamai image purge must include the query string and both pristine and derivative URLs".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.

Why this happens

The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.

Source: Official docs (Akamai, purging images): with preserve-query-args enabled, query parameters are part of the URL portion of the cache key, so the purge URL must include the exact query string or it misses the object. It gets worse with the Origin Base Path behavior, which creates different cache keys for pristine and derivative images, meaning one purge URL only clears one of the two. Agents that purge the bare image URL and declare victory leave stale derivatives served.

Verified resolution: Purge the full URL including query string when preserve-query-args is on. If Origin Base Path is in your Image and Video Manager rules, submit two purge URLs per image: the normal one for the derivative and the same URL with ?imbypass=true for the pristine version. When purging by CP code, purge pristine images before derivatives.

Source URL: http://techdocs.akamai.com/ivm/docs/bp-purge-image-cache