---
title: "PUT /v1/admin/settings/monitor"
method: PUT
path: "/v1/admin/settings/monitor"
tags: ["AdminMonitorSettingsService"]
---

# PUT /v1/admin/settings/monitor

`PUT /v1/admin/settings/monitor`

UpdateMonitorSettings 更新全局监控设置；状态码规则非法返回 400。

## Request body

- AdminV1UpdateMonitorSettingsRequest
  - `settings` AdminV1MonitorSettings — MonitorSettings 全局渠道可靠性策略（options KV：monitor.retry.status_codes / monitor.auto_disable.status_codes / monitor.auto_disable.keywords）。
    - `autoDisableKeywords` string[] — 自动禁用关键词（每行一个）：上游返回错误中包含这些关键词时（不区分大小写） 自动禁用渠道；仅认证/配额类错误参与匹配（防用户可控文本误禁）。
    - `autoDisableStatusCodes` string — 自动禁用状态码规则，语法同上；空 = 不按状态码禁用。
    - `retryStatusCodes` string — 自动重试状态码规则：单个状态码或范围（含首尾），逗号分隔，如 "429,500-503"； 空 = 未配置（回退内置集合）。504/524 恒不重试，不受此处配置影响。

## Response `200`

OK

- AdminV1UpdateMonitorSettingsReply
  - `ok` boolean

---

[API](https://skmtc.dev/apiqik/apis/apiqik-api.md) · [All operations](https://skmtc.dev/apiqik/apis/apiqik-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apiqik/apiqik-api/revisions/e06b96127408/schema)