From 904c9ac13eec2a25167c1c352b48ae7b6b44befc Mon Sep 17 00:00:00 2001
From: ysyneu <ysyneu@gmail.com>
Date: Sat, 17 Oct 2026 07:36:15 -0700
Subject: [PATCH] docs(monitors): note credential stripping in datasource list
 addresses

/monit/datasource/list returns each address entry without userinfo, query string or fragment; /monit/datasource/info still returns the stored address.
---
 api-reference/monitors.openapi.en.json | 2 +-
 api-reference/monitors.openapi.zh.json | 2 +-
 api-reference/openapi.en.json          | 2 +-
 api-reference/openapi.zh.json          | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/api-reference/monitors.openapi.en.json b/api-reference/monitors.openapi.en.json
index 71cc4812..220226fe 100644
--- a/api-reference/monitors.openapi.en.json
+++ b/api-reference/monitors.openapi.en.json
@@ -1198,7 +1198,7 @@
           "Monitors/Data sources"
         ],
         "x-mint": {
-          "content": "## Restrictions\n\n| Aspect | Value |\n| ------ | ----- |\n| Rate limits | **1,000 requests/minute**; **50 requests/second** per account |\n| Permissions | **Datasources Read** (`monit`) |\n\n## Usage\n\n- Omit `type` and `name` to return every datasource you can query; `type` and `name` are exact-match filters. An unrecognized `type` returns an empty array. The result is not paginated.\n- Only datasources the caller can query are returned (see `readonly_team_ids`); each item carries `my_perm` (`manage` or `readonly`).\n- `payload` is always `null` in list items. Use `/monit/datasource/info` to read the configuration of a datasource you can manage.",
+          "content": "## Restrictions\n\n| Aspect | Value |\n| ------ | ----- |\n| Rate limits | **1,000 requests/minute**; **50 requests/second** per account |\n| Permissions | **Datasources Read** (`monit`) |\n\n## Usage\n\n- Omit `type` and `name` to return every datasource you can query; `type` and `name` are exact-match filters. An unrecognized `type` returns an empty array. The result is not paginated.\n- Only datasources the caller can query are returned (see `readonly_team_ids`); each item carries `my_perm` (`manage` or `readonly`).\n- `payload` is always `null` in list items. Use `/monit/datasource/info` to read the configuration of a datasource you can manage.\n- `address` in list items has userinfo (`user:password@`), the query string and the fragment removed from each comma-separated entry. `/monit/datasource/info` returns the address as stored.",
           "href": "/en/api-reference/monitors/data-sources/monit-datasource-read-list",
           "metadata": {
             "sidebarTitle": "List datasources"
diff --git a/api-reference/monitors.openapi.zh.json b/api-reference/monitors.openapi.zh.json
index 92ee6fca..50dac916 100644
--- a/api-reference/monitors.openapi.zh.json
+++ b/api-reference/monitors.openapi.zh.json
@@ -1198,7 +1198,7 @@
           "Monitors/告警数据源"
         ],
         "x-mint": {
-          "content": "## 限制说明\n\n| 项目 | 说明 |\n| ---- | ---- |\n| 速率限制 | 每个账户 **1,000 次/分钟**；**50 次/秒** |\n| 权限要求 | **数据源查看**（`monit`） |\n\n## 使用说明\n\n- 省略 `type` 和 `name` 时返回你有权查询的所有数据源；`type`、`name` 均为精确匹配。无法识别的 `type` 返回空数组。结果不分页。\n- 只返回调用方有权查询的数据源（见 `readonly_team_ids`）；每项带有 `my_perm`（`manage` 或 `readonly`）。\n- 列表项中的 `payload` 恒为 `null`。如需读取自己可管理的数据源的配置，请使用 `/monit/datasource/info`。",
+          "content": "## 限制说明\n\n| 项目 | 说明 |\n| ---- | ---- |\n| 速率限制 | 每个账户 **1,000 次/分钟**；**50 次/秒** |\n| 权限要求 | **数据源查看**（`monit`） |\n\n## 使用说明\n\n- 省略 `type` 和 `name` 时返回你有权查询的所有数据源；`type`、`name` 均为精确匹配。无法识别的 `type` 返回空数组。结果不分页。\n- 只返回调用方有权查询的数据源（见 `readonly_team_ids`）；每项带有 `my_perm`（`manage` 或 `readonly`）。\n- 列表项中的 `payload` 恒为 `null`。如需读取自己可管理的数据源的配置，请使用 `/monit/datasource/info`。\n- 列表项中的 `address` 会对每个逗号分隔的地址去掉用户信息（`user:password@`）、查询串和片段（`#...`）。`/monit/datasource/info` 返回保存的原始地址。",
           "href": "/zh/api-reference/monitors/data-sources/monit-datasource-read-list",
           "metadata": {
             "sidebarTitle": "查询数据源列表"
diff --git a/api-reference/openapi.en.json b/api-reference/openapi.en.json
index 46304e04..6d90bfcb 100644
--- a/api-reference/openapi.en.json
+++ b/api-reference/openapi.en.json
@@ -48646,7 +48646,7 @@
           "Monitors/Data sources"
         ],
         "x-mint": {
-          "content": "## Restrictions\n\n| Aspect | Value |\n| ------ | ----- |\n| Rate limits | **1,000 requests/minute**; **50 requests/second** per account |\n| Permissions | **Datasources Read** (`monit`) |\n\n## Usage\n\n- Omit `type` and `name` to return every datasource you can query; `type` and `name` are exact-match filters. An unrecognized `type` returns an empty array. The result is not paginated.\n- Only datasources the caller can query are returned (see `readonly_team_ids`); each item carries `my_perm` (`manage` or `readonly`).\n- `payload` is always `null` in list items. Use `/monit/datasource/info` to read the configuration of a datasource you can manage.",
+          "content": "## Restrictions\n\n| Aspect | Value |\n| ------ | ----- |\n| Rate limits | **1,000 requests/minute**; **50 requests/second** per account |\n| Permissions | **Datasources Read** (`monit`) |\n\n## Usage\n\n- Omit `type` and `name` to return every datasource you can query; `type` and `name` are exact-match filters. An unrecognized `type` returns an empty array. The result is not paginated.\n- Only datasources the caller can query are returned (see `readonly_team_ids`); each item carries `my_perm` (`manage` or `readonly`).\n- `payload` is always `null` in list items. Use `/monit/datasource/info` to read the configuration of a datasource you can manage.\n- `address` in list items has userinfo (`user:password@`), the query string and the fragment removed from each comma-separated entry. `/monit/datasource/info` returns the address as stored.",
           "href": "/en/api-reference/monitors/data-sources/monit-datasource-read-list",
           "metadata": {
             "sidebarTitle": "List datasources"
diff --git a/api-reference/openapi.zh.json b/api-reference/openapi.zh.json
index 85f5922a..34b9f4fd 100644
--- a/api-reference/openapi.zh.json
+++ b/api-reference/openapi.zh.json
@@ -48646,7 +48646,7 @@
           "Monitors/告警数据源"
         ],
         "x-mint": {
-          "content": "## 限制说明\n\n| 项目 | 说明 |\n| ---- | ---- |\n| 速率限制 | 每个账户 **1,000 次/分钟**；**50 次/秒** |\n| 权限要求 | **数据源查看**（`monit`） |\n\n## 使用说明\n\n- 省略 `type` 和 `name` 时返回你有权查询的所有数据源；`type`、`name` 均为精确匹配。无法识别的 `type` 返回空数组。结果不分页。\n- 只返回调用方有权查询的数据源（见 `readonly_team_ids`）；每项带有 `my_perm`（`manage` 或 `readonly`）。\n- 列表项中的 `payload` 恒为 `null`。如需读取自己可管理的数据源的配置，请使用 `/monit/datasource/info`。",
+          "content": "## 限制说明\n\n| 项目 | 说明 |\n| ---- | ---- |\n| 速率限制 | 每个账户 **1,000 次/分钟**；**50 次/秒** |\n| 权限要求 | **数据源查看**（`monit`） |\n\n## 使用说明\n\n- 省略 `type` 和 `name` 时返回你有权查询的所有数据源；`type`、`name` 均为精确匹配。无法识别的 `type` 返回空数组。结果不分页。\n- 只返回调用方有权查询的数据源（见 `readonly_team_ids`）；每项带有 `my_perm`（`manage` 或 `readonly`）。\n- 列表项中的 `payload` 恒为 `null`。如需读取自己可管理的数据源的配置，请使用 `/monit/datasource/info`。\n- 列表项中的 `address` 会对每个逗号分隔的地址去掉用户信息（`user:password@`）、查询串和片段（`#...`）。`/monit/datasource/info` 返回保存的原始地址。",
           "href": "/zh/api-reference/monitors/data-sources/monit-datasource-read-list",
           "metadata": {
             "sidebarTitle": "查询数据源列表"