写 SMTP 邮件配置（平台超管）

PUT /api/v1/admin/settings/smtp · adminUpdateSmtpSettings

覆盖身份系统真实发信的 SMTP 配置（主机 / 端口 / 用户名 / 密码 / 发件人 / TLS）。 password 留空表示保留已存密码（不覆盖）；host 与 from 均非空才视为已启用真实发信，否则退回 dev outbox。密码明文存控制面库、GET 永不回显。写审计 platform.settings.update （metadata 不含密码明文）。要求平台超管。

本接口要求浏览器会话。Bearer API Token 无法调用——Token 的生命周期管理必须在网页端完成。

请求体

host（必填）: string
port（必填）: integer
username（必填）: string
password: string
from（必填）: string
fromName（必填）: string
useTls（必填）: boolean

响应字段 · 200

host（必填）: string
port（必填）: integer
username（必填）: string
from（必填）: string
fromName（必填）: string
useTls（必填）: boolean
passwordConfigured（必填）: boolean

错误

401：Problem 错误响应
403：Problem 错误响应
422：Problem 错误响应

请求示例（curl）

curl -X PUT "https://你的项目.workflow.games/api/v1/admin/settings/smtp" \
  -H "Authorization: Bearer wfp_…" \
  -H "content-type: application/json" \
  --data '{"host":"示例文本","port":1,"username":"示例标题","from":"示例文本","fromName":"示例标题","useTls":true}'

响应示例

HTTP/1.1 200
{
  "host": "示例文本",
  "port": 1,
  "username": "示例标题",
  "from": "示例文本",
  "fromName": "示例标题",
  "useTls": true,
  "passwordConfigured": true
}

合同真值：OpenAPI 3.1（0.1.0）。

相关：Agent 接入指南 · 使用指南 · API 参考索引