clear_customer() removes every cache entry whose customer scope matches customer_id, including any nested user-scoped entries that belong to that customer. Use it when offboarding a B2B tenant, when test fixtures need a clean slate, or when a customer’s data has drifted and you want to force a refresh from the platform.
This is a synchronous method, no await.
Parameters
string
required
The external customer identifier whose cached data should be dropped. Must match the
customer_id you originally passed when populating the cache. Customer scoping is a B2B concern. See B2C vs B2B.Returns
ReturnsNone.
Example
Raises
This method does not raise SDK errors. See Error Codes for the full SDK exception hierarchy.See also
- cache.clear: drop the entire local cache.
- cache.clear_user: drop one user’s cached data (GDPR).
- cache.stats: inspect hit rate and entry counts.