# Forward an email to other people

Source: https://docs.vlayers.ai/reference/messages/forward-message

`POST /v1/messages/{id}/forward` · scope `messages:send`

Forwards one email message from the mailbox that holds it. The new email is from the same mailbox, with the subject `Fwd: <original subject>`, your optional note, and the original text quoted. The files of the original go along unless `includeAttachments` is false. It goes through the normal send path, so a mailbox with review before send holds it for approval, and each person is checked and charged like any other send. Each person gets their own copy, including `cc` people; nobody sees who else received it.

Requires an API key with the `messages:send` scope.

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `id` | path | string | yes | The message id. Example: `"0192f5b0-8d1f-7b62-8c3e-5f9a2b7d4e32"` |
| `idempotency-key` | header | string | no | A unique value (a UUID works) that makes a retry safe: sending the same key again returns the first result instead of acting twice. 1–255 printable characters. Example: `"7f3c9a2e-5b1d-4c8e-9f0a-2d6b8e4c1a37"` |
| `to` | body | string[] | yes | Who to forward it to: 1 to 10 email addresses. |
| `cc` | body | string[] | no | More people to send a copy to (counted in the 10). They get their own copy, not a visible cc. |
| `note` | body | string | no | A line or two of your own, placed above the quoted message. |
| `includeAttachments` | body | boolean | no | Whether the original's files go along. Default true; `false` sends the words only. |
| `attachments` | body | object[] | no | More files to attach beside the original's (same forms as on a send). |
| `files` | body | object \| string[] | no | Email only: files the user dropped into ChatGPT, each `{ download_url, file_id, mime_type?, file_name? }`. Fetched and checked like `attachments`. |

## Request

cURL:

```bash
curl -X POST "https://api.vlayers.ai/v1/messages/$MESSAGE_ID/forward" \
  -H "Authorization: Bearer $VOICELAYER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": [
      "ada@test.vlayers.ai"
    ],
    "note": "Can you take this one?"
  }'
```

TypeScript:

```ts
import { VoiceLayer } from '@voicelayer/api';

const voicelayer = new VoiceLayer();

const { summary } = await voicelayer.messages.forward('<message-id>', {
  to: ['ada@test.vlayers.ai'],
  note: 'Can you take this one?'
});
console.log(summary);
```

Python:

```python
from voicelayer import VoiceLayer

vl = VoiceLayer()

result = vl.messages.forward(
    "<message-id>",
    to=["ada@test.vlayers.ai"],
    note="Can you take this one?",
)
print(result.summary)
```

## Response `202`

```json
{
  "summary": "Forwarded to 1 person.",
  "subject": "Fwd: Do you have a table for two tonight?",
  "results": [
    {
      "to": "ada@example.com",
      "role": "to",
      "status": "sent",
      "messageId": "0192f5b0-8d1f-7b62-8c3e-5f9a2b7d4e32",
      "error": null
    }
  ]
}
```
