用途：通过 curl 调用 Telnyx 邮件 API（https://api.telnyx.com/v2），管理邮件抑制（email blocks）、导入导出抑制列表，以及管理退订组，服务于送达率合规与退信处理。
主要能力：列出、创建、查询、软删除抑制记录并查看其审计事件；以 CSV 同步导出抑制列表，异步导入抑制列表并轮询任务；创建、查询、更新、删除退订组，列出、添加、删除组内抑制。也支持在域名级配置邮件 webhook（email.bounced、email.failed、email.complained、email.unsubscribed）。
使用方式：先执行 export TELNYX_API_KEY="YOUR_API_KEY_HERE"，所有请求携带 Authorization: Bearer $TELNYX_API_KEY。列表分页用 page[number] 与 page[size]（最大 100），主列表另支持 opaque 游标（page[after]/page[before]），偏移与游标不可混用。导入需 jq 轮询：IMPORT_ID="…" 后循环 GET /v2/email_blocks/import/$IMPORT_ID，直到 completed 或 failed。删除组抑制时路径内邮箱需百分号编码（如 subscriber%40example.com）。建议先检查 HTTP 状态码与顶层 .errors。
限制与注意事项：POST /v2/email_blocks 固定 reason 为 manual_block、source 为 manual，调用方传入的 reason/source 被忽略；scope 由服务端推导，不可自定义。unsubscribe 与 manual_block 可用 ignore_suppression: true 在发送时绕过，其余原因不可绕过。导入上限 25 MiB 或 250,000 行，格式自动识别为 sendgrid、mailgun、ses 或 generic；导出为同步 CSV 流，不创建任务。删除为软删除（tombstone，status: removed），重建可恢复。删除仍有活动抑制的退订组返回 409，可用 force=true 强制。webhook 使用 Ed25519 签名，需在验签前保留原始请求体，拒绝超时 5 分钟的请求，并按事件 ID 去重且 10 秒内返回 2xx。
适用场景：退信与投诉后的抑制维护、抑制列表迁移与导出审计、退订组管理和 webhook 退订/退信处理流程。具体费用、配额与更多字段暂未提供。