Skip to content

Agent Mesh

docs: a revoked bootstrap token is deleted after the retention

Tomas Tormoc9356f0a3f9f
diff --git a/site/content/docs/concepts/identity.md b/site/content/docs/concepts/identity.md
index 04ca8a78..5f9921f1 100644
--- a/site/content/docs/concepts/identity.md
+++ b/site/content/docs/concepts/identity.md
@@ -291,7 +291,9 @@ Revocation operates at two levels:
A bootstrap token can be revoked before it expires with
`DELETE /admin/bootstrap-tokens/{id}`. The token stays in the list, marked
-as revoked, so the record of what it enrolled is kept.
+as revoked, so the record of what it enrolled is kept. The control plane
+deletes the token once the token has been expired for `--node-retention`
+and no enrollment request made with it is left.
## What a node proves on every connection
diff --git a/site/content/docs/guides/headless-enrollment.md b/site/content/docs/guides/headless-enrollment.md
index 7bc2e376..6bb8793a 100644
--- a/site/content/docs/guides/headless-enrollment.md
+++ b/site/content/docs/guides/headless-enrollment.md
@@ -186,8 +186,10 @@ curl -fsS -X DELETE https://mesh.example.com/admin/bootstrap-tokens/<id> \
```
The token stays in the list, marked as revoked, so the record of what it
-enrolled is kept. Nodes that already enrolled with it are not affected. To
-remove one of those, ban the node.
+enrolled is kept. The control plane deletes the token once the token has
+been expired for `--node-retention` and no enrollment request made with it
+is left. Nodes that already enrolled with it are not affected. To remove one
+of those, ban the node.
## When the credential expires