> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# 转发邮件
> 把单封邮件转发给新的收件人，返回 message_id 和 thread_id。
把单封邮件转发给新的收件人，返回 `message_id` 和 `thread_id`。🔴 **这会发出真实邮件且收不回，并会连同原文和附件一起带走**——先用 `get_agentmail_inbox_message` 看清楚要转发什么。所有 AIsa 调用方共用同一个 AgentMail 账号，因此这里会触及其他调用方创建的收件箱。要回复而非转发，用 `post_agentmail_inbox_message_reply`。
## 示例
```bash REST theme={null}
curl -X POST "https://api.aisa.one/apis/v1/agentmail/inboxes/{inbox_id}/messages/{message_id}/forward" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY"
```
```jsonc MCP theme={null}
// 把整段复制给 Claude Code、Codex、Cursor 或任意 coding agent。
// 连接、授权、跑通这个例子需要的东西都在里面 ——
// 不用粘贴任何 key，浏览器里点一次 Allow 就好。
{
"operation_id": "post_agentmail_inbox_message_forward",
"arguments": {},
"max_price_usd": 0.05
}
// ── for the agent ─────────────────────────────────────────────────────────
// Register the AIsa MCP server, then call its `use` tool with the JSON above.
// name aisa
// endpoint https://mcp.aisa.one/mcp
// transport streamable-http
// auth OAuth. The server publishes RFC 9728 metadata, so open a
// browser and the user clicks Allow once — nothing to paste.
// If AISA_API_KEY is set, send it as a bearer header instead.
// Use your own MCP mechanism, not a hand-edited config file:
// Codex codex mcp add aisa --url https://mcp.aisa.one/mcp
// Claude Code claude mcp add --transport http -s user aisa https://mcp.aisa.one/mcp
// Cursor / VS Code a "url" entry for https://mcp.aisa.one/mcp in the MCP config
// The server lists five tools over https://mcp.aisa.one/servers worth of APIs:
// search, get_details, use, batch_use, list_categories. search and
// get_details are free; use is billed per call and max_price_usd refuses
// anything above the cap before spending. This operation's full contract —
// every argument, the response shape, the price and the pitfalls — is at
// https://aisa.one/docs/zh/api-reference/agentmail/post_agentmail-inboxes-inbox-id-messages-message-id-forward.md
// Then run the call and show me the result.
```
**第一次用？** 把任意 MCP 客户端指向 `https://mcp.aisa.one/mcp` —— Claude Code、
Codex、Cursor、VS Code 都可以。鉴权走 OAuth：客户端打开浏览器，你点一次
Allow，不需要粘贴任何 key。各客户端的具体命令和每次调用的价格见
[aisa.one/zh-cn/mcp](https://aisa.one/zh-cn/mcp#connect)。
[在你的 agent 里把这个端点跑起来 →](https://aisa.one/mcp?from=/zh/api-reference/agentmail/post_agentmail-inboxes-inbox-id-messages-message-id-forward)
## OpenAPI
````yaml openapi/zh/agentmail.json POST /agentmail/inboxes/{inbox_id}/messages/{message_id}/forward
openapi: 3.1.0
info:
title: AgentMail API
version: 1.0.0
description: 通过 AIsa 统一网关公开的 AgentMail 电子邮件 API 端点。改编自上游 docs.agentmail.to OpenAPI 规范。
servers:
- url: https://api.aisa.one/apis/v1
security:
- Bearer: []
paths:
/agentmail/inboxes/{inbox_id}/messages/{message_id}/forward:
post:
tags:
- subpackage_inboxes.subpackage_inboxes/messages
summary: 转发邮件
description: >-
把单封邮件转发给新的收件人，返回 `message_id` 和 `thread_id`。🔴
**这会发出真实邮件且收不回，并会连同原文和附件一起带走**——先用 `get_agentmail_inbox_message`
看清楚要转发什么。所有 AIsa 调用方共用同一个 AgentMail 账号，因此这里会触及其他调用方创建的收件箱。要回复而非转发，用
`post_agentmail_inbox_message_reply`。
operationId: post_agentmail_inbox_message_forward
parameters:
- name: inbox_id
in: path
required: true
schema:
$ref: '#/components/schemas/type_inboxes_InboxId'
- name: message_id
in: path
required: true
schema:
$ref: '#/components/schemas/type_messages_MessageId'
- name: Authorization
in: header
description: Bearer 身份验证
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/type_messages_SendMessageRequest'
responses:
'200':
description: 状态码为 200 的响应
content:
application/json:
schema:
$ref: '#/components/schemas/type_messages_SendMessageResponse'
'400':
description: 状态码为 400 的错误响应
content:
application/json:
schema:
$ref: '#/components/schemas/type__ValidationErrorResponse'
'403':
description: 状态码为 403 的错误响应
content:
application/json:
schema:
$ref: '#/components/schemas/type__ErrorResponse'
'404':
description: 状态码为 404 的错误响应
content:
application/json:
schema:
$ref: '#/components/schemas/type__ErrorResponse'
components:
schemas:
type_inboxes_InboxId:
type: string
description: 收件箱的 ID。
title: InboxId
type_messages_MessageId:
type: string
description: 消息 ID。
title: MessageId
type_messages_SendMessageRequest:
type: object
properties:
labels:
$ref: '#/components/schemas/type_messages_MessageLabels'
reply_to:
$ref: '#/components/schemas/type_messages_SendMessageReplyTo'
to:
$ref: '#/components/schemas/type_messages_SendMessageTo'
cc:
$ref: '#/components/schemas/type_messages_SendMessageCc'
bcc:
$ref: '#/components/schemas/type_messages_SendMessageBcc'
subject:
$ref: '#/components/schemas/type_messages_MessageSubject'
text:
$ref: '#/components/schemas/type_messages_MessageText'
html:
$ref: '#/components/schemas/type_messages_MessageHtml'
attachments:
$ref: '#/components/schemas/type_messages_SendMessageAttachments'
headers:
$ref: '#/components/schemas/type_messages_SendMessageHeaders'
title: SendMessageRequest
type_messages_SendMessageResponse:
type: object
properties:
message_id:
$ref: '#/components/schemas/type_messages_MessageId'
thread_id:
$ref: '#/components/schemas/type_threads_ThreadId'
required:
- message_id
- thread_id
title: SendMessageResponse
type__ValidationErrorResponse:
type: object
properties:
name:
$ref: '#/components/schemas/type__ErrorName'
errors:
description: 验证错误。
required:
- name
- errors
title: ValidationErrorResponse
type__ErrorResponse:
type: object
properties:
name:
$ref: '#/components/schemas/type__ErrorName'
message:
$ref: '#/components/schemas/type__ErrorMessage'
required:
- name
- message
title: ErrorResponse
type_messages_MessageLabels:
type: array
items:
type: string
description: 消息标签。
title: MessageLabels
type_messages_SendMessageReplyTo:
$ref: '#/components/schemas/type_messages_Addresses'
description: 回复地址（一个或多个）。
title: SendMessageReplyTo
type_messages_SendMessageTo:
$ref: '#/components/schemas/type_messages_Addresses'
description: 收件人地址。
title: SendMessageTo
type_messages_SendMessageCc:
$ref: '#/components/schemas/type_messages_Addresses'
description: 抄送收件人地址。
title: SendMessageCc
type_messages_SendMessageBcc:
$ref: '#/components/schemas/type_messages_Addresses'
description: 密送收件人地址。
title: SendMessageBcc
type_messages_MessageSubject:
type: string
description: 消息主题。
title: MessageSubject
type_messages_MessageText:
type: string
description: 消息的纯文本正文。
title: MessageText
type_messages_MessageHtml:
type: string
description: 消息的 HTML 正文。
title: MessageHtml
type_messages_SendMessageAttachments:
type: array
items:
$ref: '#/components/schemas/type_attachments_SendAttachment'
description: 消息中要包含的附件。
title: SendMessageAttachments
type_messages_SendMessageHeaders:
type: object
additionalProperties:
type: string
description: 消息中要包含的标头。
title: SendMessageHeaders
type_threads_ThreadId:
type: string
description: 会话 ID。
title: ThreadId
type__ErrorName:
type: string
description: 错误名称。
title: ErrorName
type__ErrorMessage:
type: string
description: 错误消息。
title: ErrorMessage
type_messages_Addresses:
oneOf:
- type: string
- type: array
items:
type: string
title: Addresses
type_attachments_SendAttachment:
type: object
properties:
filename:
$ref: '#/components/schemas/type_attachments_AttachmentFilename'
content_type:
$ref: '#/components/schemas/type_attachments_AttachmentContentType'
content_disposition:
$ref: '#/components/schemas/type_attachments_AttachmentContentDisposition'
content_id:
$ref: '#/components/schemas/type_attachments_AttachmentContentId'
content:
type: string
description: 附件的 Base64 编码内容。
url:
type: string
description: 附件的 URL。
title: SendAttachment
type_attachments_AttachmentFilename:
type: string
description: 附件文件名。
title: AttachmentFilename
type_attachments_AttachmentContentType:
type: string
description: 附件的内容类型。
title: AttachmentContentType
type_attachments_AttachmentContentDisposition:
type: string
enum:
- inline
- attachment
description: 附件的内容处置方式。
title: AttachmentContentDisposition
type_attachments_AttachmentContentId:
type: string
description: 附件的内容 ID。
title: AttachmentContentId
securitySchemes:
Bearer:
type: http
scheme: bearer
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.