diff --git a/api-reference/openapi.en.json b/api-reference/openapi.en.json
index 6557ee4e..b60f13af 100644
--- a/api-reference/openapi.en.json
+++ b/api-reference/openapi.en.json
@@ -21472,6 +21472,10 @@
             "description": "Display group used to cluster fields in the console, such as `error`, `action` or `device`. Empty when the field has no group.",
             "type": "string"
           },
+          "high_cardinality": {
+            "description": "True when grouping by this field is restricted: event ID fields cannot be grouped at all, other high-cardinality fields only with count or sum.",
+            "type": "boolean"
+          },
           "is_facet": {
             "description": "True if value distribution counting is supported for this field.",
             "type": "boolean"
@@ -21551,6 +21555,7 @@
           "unit_name",
           "edit_able",
           "is_facet",
+          "high_cardinality",
           "enum_values",
           "scopes",
           "status",
@@ -58461,6 +58466,7 @@
                         "field_key": "error_type",
                         "field_name": "Error Type",
                         "group": "error",
+                        "high_cardinality": false,
                         "is_facet": true,
                         "queryable": true,
                         "scopes": [
diff --git a/api-reference/openapi.zh.json b/api-reference/openapi.zh.json
index ae1d059e..24bc1fee 100644
--- a/api-reference/openapi.zh.json
+++ b/api-reference/openapi.zh.json
@@ -21472,6 +21472,10 @@
             "description": "控制台中对字段分组展示所用的组名，如 `error`、`action`、`device`；无分组时为空。",
             "type": "string"
           },
+          "high_cardinality": {
+            "description": "为 true 时表示按该字段分组受限：事件 ID 类字段完全不可分组，其他高基数字段只能用 count 或 sum 聚合。",
+            "type": "boolean"
+          },
           "is_facet": {
             "description": "是否支持值分布统计查询。",
             "type": "boolean"
@@ -21551,6 +21555,7 @@
           "unit_name",
           "edit_able",
           "is_facet",
+          "high_cardinality",
           "enum_values",
           "scopes",
           "status",
@@ -58461,6 +58466,7 @@
                         "field_key": "error_type",
                         "field_name": "Error Type",
                         "group": "error",
+                        "high_cardinality": false,
                         "is_facet": true,
                         "queryable": true,
                         "scopes": [
diff --git a/api-reference/rum.openapi.en.json b/api-reference/rum.openapi.en.json
index d3e92799..ff0a3334 100644
--- a/api-reference/rum.openapi.en.json
+++ b/api-reference/rum.openapi.en.json
@@ -1973,6 +1973,10 @@
             "description": "Display group used to cluster fields in the console, such as `error`, `action` or `device`. Empty when the field has no group.",
             "type": "string"
           },
+          "high_cardinality": {
+            "description": "True when grouping by this field is restricted: event ID fields cannot be grouped at all, other high-cardinality fields only with count or sum.",
+            "type": "boolean"
+          },
           "is_facet": {
             "description": "True if value distribution counting is supported for this field.",
             "type": "boolean"
@@ -2052,6 +2056,7 @@
           "unit_name",
           "edit_able",
           "is_facet",
+          "high_cardinality",
           "enum_values",
           "scopes",
           "status",
@@ -10463,6 +10468,7 @@
                         "field_key": "error_type",
                         "field_name": "Error Type",
                         "group": "error",
+                        "high_cardinality": false,
                         "is_facet": true,
                         "queryable": true,
                         "scopes": [
diff --git a/api-reference/rum.openapi.zh.json b/api-reference/rum.openapi.zh.json
index 078cf127..0a5e8514 100644
--- a/api-reference/rum.openapi.zh.json
+++ b/api-reference/rum.openapi.zh.json
@@ -1973,6 +1973,10 @@
             "description": "控制台中对字段分组展示所用的组名，如 `error`、`action`、`device`；无分组时为空。",
             "type": "string"
           },
+          "high_cardinality": {
+            "description": "为 true 时表示按该字段分组受限：事件 ID 类字段完全不可分组，其他高基数字段只能用 count 或 sum 聚合。",
+            "type": "boolean"
+          },
           "is_facet": {
             "description": "是否支持值分布统计查询。",
             "type": "boolean"
@@ -2052,6 +2056,7 @@
           "unit_name",
           "edit_able",
           "is_facet",
+          "high_cardinality",
           "enum_values",
           "scopes",
           "status",
@@ -10463,6 +10468,7 @@
                         "field_key": "error_type",
                         "field_name": "Error Type",
                         "group": "error",
+                        "high_cardinality": false,
                         "is_facet": true,
                         "queryable": true,
                         "scopes": [