diff --git a/api-reference/openapi.en.json b/api-reference/openapi.en.json
index ea38f102a..5c2bdd216 100644
--- a/api-reference/openapi.en.json
+++ b/api-reference/openapi.en.json
@@ -1320,6 +1320,10 @@
             "description": "Alert description.",
             "type": "string"
           },
+          "detail_url": {
+            "description": "Console URL of this alert (`{console}/alert/detail/{alert_id}`). Empty when the deployment has no console base configured.",
+            "type": "string"
+          },
           "end_time": {
             "description": "Unix timestamp (seconds) when the alert recovered. 0 if still active.",
             "format": "int64",
@@ -1541,6 +1545,10 @@
             "description": "Alert description.",
             "type": "string"
           },
+          "detail_url": {
+            "description": "Console URL of this alert (`{console}/alert/detail/{alert_id}`). Empty when the deployment has no console base configured.",
+            "type": "string"
+          },
           "end_time": {
             "description": "Resolution time, Unix epoch seconds. 0 if still active.",
             "format": "int64",
diff --git a/api-reference/openapi.zh.json b/api-reference/openapi.zh.json
index 770ca7810..afedef7f7 100644
--- a/api-reference/openapi.zh.json
+++ b/api-reference/openapi.zh.json
@@ -1320,6 +1320,10 @@
             "description": "告警描述。",
             "type": "string"
           },
+          "detail_url": {
+            "description": "这条告警的控制台页面（`{控制台}/alert/detail/{alert_id}`）。部署没有配置控制台地址时为空。",
+            "type": "string"
+          },
           "end_time": {
             "description": "告警恢复的 Unix 时间戳（秒），仍活跃时为 0。",
             "format": "int64",
@@ -1541,6 +1545,10 @@
             "description": "告警描述。",
             "type": "string"
           },
+          "detail_url": {
+            "description": "这条告警的控制台页面（`{控制台}/alert/detail/{alert_id}`）。部署没有配置控制台地址时为空。",
+            "type": "string"
+          },
           "end_time": {
             "description": "恢复时间，Unix 时间戳（秒）。活跃时为 0。",
             "format": "int64",