Incorrect information in Purge cache documentation

[isaumya]

Existing documentation URL(s)

https://developers.cloudflare.com/cache/how-to/purge-cache/

What changes are you suggesting?

The purge cache limitation table on this page suggests that whether using Purge by File/URL, Cache-Tag, Prefix, Hostname — each API call can have 100 cache keys as part of the body. Which is not true.

For "Purge by URL/File" — the purge key limit remains 30 as it was before.

The introduction of instant purge and the new Cache Key limit of 100 only applies for:

• Purge by prefix
• purge by cache-tag
• purge by hostname

Unfortunately, this key information is not mentioned anywhere on this documentation page.

Please update the page and add this key information amount the number of cache keys that can be passed on cache purge calls based on the different cache purge methods that is being used.

Additional information

If you make an API call for cache purge via purge by prefix, cache-tag or hostname and pass more than 100 cache keys. In the API error message, it clearly says that you cannot provide more than 100 items.

But if you make the same call for purge by file a.k.a. purge by URL, then it just says that you are exceeding the limit without explicitly mentioning what the limit actually is.

Maybe this is also something to put in the documentation.

[angelampcosta]

@isaumya thanks for opening this issue. It's addressed in #21561