diff --git a/api-reference/openapi.json b/api-reference/openapi.json
index 4f58d5b6..f1029f70 100644
--- a/api-reference/openapi.json
+++ b/api-reference/openapi.json
@@ -10704,7 +10704,7 @@
         "example": "html"
       },
       "TagHandlingVersionOption": {
-        "description": "Sets which version of the tag handling algorithm should be used. Options currently available:\n* `v1`: Traditional algorithm (currently the default, will become deprecated in the future).\n* `v2`: Improved algorithm released in October 2025 (will become the default in the future).",
+        "description": "Sets which version of the tag handling algorithm should be used. Options currently available:\n* `v1`: Traditional algorithm (will become deprecated in the future).\n* `v2`: Improved algorithm released in October 2025. This is the default.\n\nThe `tag_handling_version` field in the response shows which version was applied.",
         "type": "string",
         "enum": [
           "v2",
diff --git a/api-reference/openapi.yaml b/api-reference/openapi.yaml
index 20e28599..c0dda760 100644
--- a/api-reference/openapi.yaml
+++ b/api-reference/openapi.yaml
@@ -8085,8 +8085,10 @@ components:
     TagHandlingVersionOption:
       description: |-
         Sets which version of the tag handling algorithm should be used. Options currently available:
-        * `v1`: Traditional algorithm (currently the default, will become deprecated in the future).
-        * `v2`: Improved algorithm released in October 2025 (will become the default in the future).
+        * `v1`: Traditional algorithm (will become deprecated in the future).
+        * `v2`: Improved algorithm released in October 2025. This is the default.
+
+        The `tag_handling_version` field in the response shows which version was applied.
 
       type: string
       enum: