diff --git a/doc/tokens.schema.json b/doc/tokens.schema.json
index b93eafe..cc9a429 100644
--- a/doc/tokens.schema.json
+++ b/doc/tokens.schema.json
@@ -155,6 +155,10 @@
           "type": "string",
           "description": "Token secret. May be empty only in a manual skeleton."
         },
+        "token_ref": {
+          "type": "string",
+          "description": "Local token name, for example t1. Optional; value may also be entered as t1:SECRET and rvctl normalizes it."
+        },
         "server": {
           "$ref": "#/$defs/server"
         },