gws.mail.forward
Create a draft that forwards an existing email to new recipients, optionally adding a comment. Returns a draft ID to send via mail.send_draft.
Instructions
Build a forward DRAFT of an existing message (does NOT send). The draft carries the original message's headers and body in the standard forwarded-message block, optionally prepended with a note. Returns the draft ID — send it with mail.send_draft. Attachments are listed by filename in the quoted block but not re-attached; use mail.get_attachment to pull their bytes.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"messageId": "<messageId>",
"to": "<to>"
},
"name": "gws.mail.forward"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cc | No | CC recipients, comma-separated | |
| to | Yes | Recipient email(s), comma-separated | |
| bcc | No | BCC recipients, comma-separated | |
| account | No | Account label or email. Uses default if omitted. | |
| comment | No | Optional note prepended above the forwarded content | |
| messageId | Yes | The message ID to forward |