From 63decdc6527dea907a35ee1f8ea4f3854999c348 Mon Sep 17 00:00:00 2001 From: ysyneu Date: Fri, 18 Sep 2026 18:20:21 -0700 Subject: [PATCH] openapi: add agent_instructions to MemberNotifyResponse /member/notify returns this advisory field when the submitted HTML body does not follow the default email layout (no max-width:600px wrapper), on dry runs and real sends alike. --- api-reference/openapi.en.json | 4 ++++ api-reference/openapi.zh.json | 4 ++++ api-reference/platform.openapi.en.json | 4 ++++ api-reference/platform.openapi.zh.json | 4 ++++ 4 files changed, 16 insertions(+) diff --git a/api-reference/openapi.en.json b/api-reference/openapi.en.json index 885302b9..50243ea7 100644 --- a/api-reference/openapi.en.json +++ b/api-reference/openapi.en.json @@ -29274,6 +29274,10 @@ "html": { "type": "string", "description": "Only present when `dry_run` is `true`: the complete email HTML exactly as recipients would receive it, after sanitization." + }, + "agent_instructions": { + "type": "string", + "description": "Present when the submitted HTML body does not follow the default email layout (no `max-width:600px` wrapper table): guidance telling the calling AI SRE agent how to conform. Advisory only — a format the caller deliberately chose needs no change. Returned on dry runs and real sends alike." } } }, diff --git a/api-reference/openapi.zh.json b/api-reference/openapi.zh.json index 40465873..ddaf0e7a 100644 --- a/api-reference/openapi.zh.json +++ b/api-reference/openapi.zh.json @@ -29274,6 +29274,10 @@ "html": { "type": "string", "description": "仅当 `dry_run` 为 `true` 时返回：清洗后、收件人将收到的完整邮件 HTML。" + }, + "agent_instructions": { + "type": "string", + "description": "当提交的 HTML 正文不符合默认邮件版式（缺少 `max-width:600px` 外层包裹表格）时返回：告知调用的 AI SRE agent 如何对齐的指引。仅为建议——调用方有意选择的格式无需改动。dry run 与真实发送均会返回。" } } }, diff --git a/api-reference/platform.openapi.en.json b/api-reference/platform.openapi.en.json index 47f747d4..f5c5e26a 100644 --- a/api-reference/platform.openapi.en.json +++ b/api-reference/platform.openapi.en.json @@ -4581,6 +4581,10 @@ "html": { "type": "string", "description": "Only present when `dry_run` is `true`: the complete email HTML exactly as recipients would receive it, after sanitization." + }, + "agent_instructions": { + "type": "string", + "description": "Present when the submitted HTML body does not follow the default email layout (no `max-width:600px` wrapper table): guidance telling the calling AI SRE agent how to conform. Advisory only — a format the caller deliberately chose needs no change. Returned on dry runs and real sends alike." } } }, diff --git a/api-reference/platform.openapi.zh.json b/api-reference/platform.openapi.zh.json index 3cca6c26..22d69cb8 100644 --- a/api-reference/platform.openapi.zh.json +++ b/api-reference/platform.openapi.zh.json @@ -4581,6 +4581,10 @@ "html": { "type": "string", "description": "仅当 `dry_run` 为 `true` 时返回：清洗后、收件人将收到的完整邮件 HTML。" + }, + "agent_instructions": { + "type": "string", + "description": "当提交的 HTML 正文不符合默认邮件版式（缺少 `max-width:600px` 外层包裹表格）时返回：告知调用的 AI SRE agent 如何对齐的指引。仅为建议——调用方有意选择的格式无需改动。dry run 与真实发送均会返回。" } } },