Skip to navigation

Clear CloudFlare cache

Purges your own store’s cached Entria data. Requires Authorization: Bearer <token> (from POST /oauth/token) minted for the store named on the x-entria header. Two modes, and they cannot be combined: set tag (entria-products, entria-categories, entria-agreements, or entria-members for the 5-minute member lookups and renewal lists) to purge your store’s copy of that tag, or set key to drop a single cached item — cart_… ids are supported, and the response reports purged: false when nothing was cached for that key, which is not an error. purgedTags in the response always names the tag that was actually purged.

Authentication

AuthorizationBearer

OAuth client token, for a partner backend only. A short-lived access token for endpoints that return personal data about any member. Obtain one from POST /oauth/token (RFC 7523 JWT-bearer), signing the assertion with the private key of the key pair registered for your store. Sent as Authorization: Bearer <token>. This is separate from the x-entria store header, which is still required.

Headers

x-entriastringRequired

Identifies which store this request is for. Required on every store-scoped route. It is not authentication and not a secret — it grants no privileges and is safe to send from a browser. You receive the value once your Entria backend has been created and configured. Missing header returns 400; an unknown store returns 404.

Query parameters

tagenumOptional

The catalog Cache-Tag to purge for your store. Required unless key is set.

keystringOptional

Purge one individually-cached item instead of a tag. The entity is taken from the id prefix; cart_… is the only one supported. Cannot be combined with tag.

Response

Cache cleared successfully
messagestring
purgedTagslist of strings
purgedKeystringOptional

Set when key was purged.

purgedbooleanOptional

Set when key was purged: false means nothing was cached for it, which is not an error.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error
503
Service Unavailable Error