用途：通过 curl 调用 Telnyx Email Inbound API，管理账户下的收件箱、入站邮件、会话线程与发件人过滤，并执行回复、全部回复和转发，适合构建读取与处理邮件的邮件智能体。
主要能力：创建、列出、获取、软删除收件箱；列出与搜索入站邮件（支持发件人、主题、时间、已读状态、标签、全文搜索等过滤与游标分页）；标记邮件已读或未读；回复、全部回复、转发邮件；按收件箱或账户列出会话线程并获取线程内消息；查看、添加、替换、删除发件人允许/阻止列表。
使用方式：curl 通常已预装。设置环境变量：export TELNYX_API_KEY="YOUR_API_KEY_HERE" 与 export TELNYX_API_BASE="https://api.telnyx.com/v2"。每个请求携带 Authorization: Bearer $TELNYX_API_KEY。带方括号的过滤参数建议用 curl --get --data-urlencode 编码。资源 ID 为 UUID，应保存创建或列表返回的 ID，而非从邮箱地址解析。
限制与注意：错误码包括 400、401、403、404、422、429、503，生产环境应单独捕获 HTTP 状态码。会话身份是 (inbox_id, thread_id) 组合，账户级接口需以 inbox_id 查询参数补全。标签是可变的邮箱状态，与出站计费标签不同，标签修改路由暂未提供。发件人过滤不区分大小写，阻止列表优先于允许列表，空列表表示接受所有发件人。回复与转发使用收件箱域名，需解析到有效发送域名。搜索为 PostgreSQL 全文搜索，非字面子串匹配。删除收件箱为软删除并保留地址，返回 204 无响应体。不要臆造参数、枚举、响应字段或 webhook 字段，未内联展示的字段应先查阅 references/api-details.md。