diff --git a/README.md b/README.md
index 0e692dae..a322429d 100644
--- a/README.md
+++ b/README.md
@@ -279,6 +279,27 @@ local account and assign it the create administrator role. That account can
then be used to create further administrators (including itself) without
needing to login as root. The root account can then be disabled.
+### Revoking tokens in an emergency
+
+The simple HTML only test UI included with the server supports most administration functions,
+but revoking all tokens in the service is not included as it has a major impact on systems the
+auth server supports, essentially shutting them down. If all tokens are revoked, the tokens for
+every single token type (agent, service, etc.) for every single user in the auth system are
+removed - the equivalent of clearing the tokens collection in MongoDB.
+
+This feature is intended to be used in an emergency such as many tokens becoming compromised or
+the system needs to come to a near immediate halt (near immediate since services outside the auth
+server may cache and accept tokens for some period of time after they're invalidated in auth).
+
+To revoke all tokens, issue the following request to the server (curl used as an example):
+
+```
+curl -X POST --cookie "kbase_session=
Allowed post-login redirect URL prefix: -
Redirect URL when a user cannot be logged in immediately after return from 3rd party provider, e.g. a choice of accounts is required or an account must be created. -
Redirect URL after an account link (usually to a user page showing their identities). -
Redirect URL when a user account cannot be linked immediately after return from 3rd party provider, e.g. a choice of accounts is required. -
@@ -87,24 +87,24 @@ provider, e.g. a choice of accounts is required. - +