Skip to content
Optiwork API Docs

Forward a message

POST
/mail/mailboxes/{mailbox}/messages/{messageId}/forward
curl --request POST \
  --url https://mail.work.optidata.cloud/api/mail/mailboxes/78/messages/4186/forward \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "draft_id": 920, "to": [ "finance@acme.example" ], "subject": "Fwd: Quarterly report", "body": "<p>Forwarding for your records.</p>", "attachments": [ { "part": "2" } ] }'

Forward {messageId} to new recipients. Send attachments listing the MIME part numbers of the original message you want carried over — omit it to forward the body only. Files you added to the draft are attached as well, and a part that is already embedded inline in the body is not attached twice.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters”
mailbox
required
integer

Id of the mailbox. Every mailbox the caller may use is listed in their account.

messageId
required
string

Id of the message.

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
draft_id
required

Id of the saved draft carrying the body and the attachments.

string | integer
to
required

Recipient addresses. At least one is required.

Array<string>
>= 1 items
cc
Array<string> | null
bcc
Array<string> | null
subject
string | null
body

HTML body.

string | null
date

Send date. Defaults to now.

string | null
is_read_receipt_enabled
boolean | null
attachments

MIME parts of the original message to carry over.

Array<object>
object
part

The part value from the original message’s attachment list.

string
Examples
ExamplewithOriginalFile
{
  "draft_id": 920,
  "to": [
    "finance@acme.example"
  ],
  "subject": "Fwd: Quarterly report",
  "body": "<p>Forwarding for your records.</p>",
  "attachments": [
    {
      "part": "2"
    }
  ]
}

Responses

Section titled “ Responses ”

200

Section titled “200”

The forward was accepted for sending. The original message is echoed back.

Media typeapplication/json

A message as it appears inside a listing or a thread.

object
id
string | integer
date
string
subject
string | null
fragment
string | null
conversationId
string | integer | null
messageIdHeader

The RFC 5322 Message-ID header.

string | null
sizeBytes
integer | null
folderId
string | integer | null
flags

The state of a message or thread, as a set of booleans.

object
isUnread
boolean
isFlagged

The user starred it.

boolean
hasAttachment
boolean
isReplied
boolean
isSentByMe
boolean
isForwarded
boolean
isInvite

It carries a calendar invitation.

boolean
isDraft
boolean
isDeleted
boolean
isNotificationSent

A read receipt was requested.

boolean
isUrgent
boolean
isLowPriority
boolean
isPriority
boolean
participants

The addresses of a message, grouped by role.

object
from
Array<object>

One participant of a message.

object
name

Display name, when one is known.

string | null
email
string format: email
type

The role the address plays: f sender, t recipient, c carbon copy, b blind copy, r reply-to.

string | null
to
Array<object>

One participant of a message.

object
name

Display name, when one is known.

string | null
email
string format: email
type

The role the address plays: f sender, t recipient, c carbon copy, b blind copy, r reply-to.

string | null
cc
Array<object>

One participant of a message.

object
name

Display name, when one is known.

string | null
email
string format: email
type

The role the address plays: f sender, t recipient, c carbon copy, b blind copy, r reply-to.

string | null
bcc
Array<object>

One participant of a message.

object
name

Display name, when one is known.

string | null
email
string format: email
type

The role the address plays: f sender, t recipient, c carbon copy, b blind copy, r reply-to.

string | null
replyTo
Array<object>

One participant of a message.

object
name

Display name, when one is known.

string | null
email
string format: email
type

The role the address plays: f sender, t recipient, c carbon copy, b blind copy, r reply-to.

string | null
sender
Array<object>

One participant of a message.

object
name

Display name, when one is known.

string | null
email
string format: email
type

The role the address plays: f sender, t recipient, c carbon copy, b blind copy, r reply-to.

string | null
notification
Array<object>

One participant of a message.

object
name

Display name, when one is known.

string | null
email
string format: email
type

The role the address plays: f sender, t recipient, c carbon copy, b blind copy, r reply-to.

string | null
resentFrom
Array<object>

One participant of a message.

object
name

Display name, when one is known.

string | null
email
string format: email
type

The role the address plays: f sender, t recipient, c carbon copy, b blind copy, r reply-to.

string | null
body

Left empty in listings; read the body with a reader operation.

Array
attachments
Array<object>

A file carried by a message.

object
part

MIME part number, used to download it.

string | integer
filename
string | null
contentType
string | null
contentId

The cid an inline image is referenced by inside the body.

string | null
disposition

attachment or inline.

string | null
hasExplicitAttachmentDisposition
boolean
fallbackOrdinal

Position used to name a file that arrived without one.

integer | null
sizeBytes
integer | null
icon

Icon hint for a file-type badge.

string | null
url

Signed download link, populated by the reader operations. Use it as-is.

string | null
inlineAttachments
Array<object>

A file carried by a message.

object
part

MIME part number, used to download it.

string | integer
filename
string | null
contentType
string | null
contentId

The cid an inline image is referenced by inside the body.

string | null
disposition

attachment or inline.

string | null
hasExplicitAttachmentDisposition
boolean
fallbackOrdinal

Position used to name a file that arrived without one.

integer | null
sizeBytes
integer | null
icon

Icon hint for a file-type badge.

string | null
url

Signed download link, populated by the reader operations. Use it as-is.

string | null
tagIds
Array<string | integer>
invite

The calendar invitation carried by the message, when there is one.

object | null
share

The folder-sharing offer carried by the message, when there is one.

object | null
Example
{
  "id": "4186",
  "participants": {
    "from": [
      {
        "name": "Jane Doe",
        "email": "jane.doe@acme.example",
        "type": "f"
      }
    ],
    "to": [
      {
        "name": "Jane Doe",
        "email": "jane.doe@acme.example",
        "type": "f"
      }
    ],
    "cc": [
      {
        "name": "Jane Doe",
        "email": "jane.doe@acme.example",
        "type": "f"
      }
    ],
    "bcc": [
      {
        "name": "Jane Doe",
        "email": "jane.doe@acme.example",
        "type": "f"
      }
    ],
    "replyTo": [
      {
        "name": "Jane Doe",
        "email": "jane.doe@acme.example",
        "type": "f"
      }
    ],
    "sender": [
      {
        "name": "Jane Doe",
        "email": "jane.doe@acme.example",
        "type": "f"
      }
    ],
    "notification": [
      {
        "name": "Jane Doe",
        "email": "jane.doe@acme.example",
        "type": "f"
      }
    ],
    "resentFrom": [
      {
        "name": "Jane Doe",
        "email": "jane.doe@acme.example",
        "type": "f"
      }
    ]
  },
  "attachments": [
    {
      "part": "2",
      "filename": "report.docx",
      "contentType": "application/pdf",
      "disposition": "attachment"
    }
  ],
  "inlineAttachments": [
    {
      "part": "2",
      "filename": "report.docx",
      "contentType": "application/pdf",
      "disposition": "attachment"
    }
  ]
}

401

Section titled “401”

Missing, malformed or expired authentication key.

Media typeapplication/json

Authentication failures use an error key rather than message.

object
error
required
string
Examples
Examplemissing

No bearer token sent

{
  "error": "JWT passport exception: Missing bearer token in request"
}

403

Section titled “403”

The caller may not act on this mailbox, user or resource.

Media typeapplication/json

Generic error envelope used by policy, binding and framework failures.

object
message
required

Human-readable description of the failure.

string
Examples
Exampledenied
{
  "message": "This action is unauthorized."
}

422

Section titled “422”

The request body or query string failed validation.

Media typeapplication/json
object
message
required

The first validation message.

string
errors
required

Validation messages keyed by field name.

object
key
additional properties
Array<string>
Examples
Exampleinvalid
{
  "message": "The conversations field is required.",
  "errors": {
    "conversation_ids": [
      "The conversations field is required."
    ]
  }
}

429

Section titled “429”

Rate limit exceeded. Retry after the window resets.

Media typeapplication/json

Generic error envelope used by policy, binding and framework failures.

object
message
required

Human-readable description of the failure.

string
Examples
Examplethrottled
{
  "message": "Too Many Attempts."
}

502

Section titled “502”

The mail platform did not answer as expected — a folder or message that does not exist, or a transient failure. reference is the code to quote to support and fault_code names the underlying condition. A 503 with the same envelope means the platform is in maintenance; retry shortly.

Media typeapplication/json

Failure raised by the mail platform behind the API rather than by the request itself.

object
error
required

What went wrong, phrased for the end user.

string
status
required

Repeats the HTTP status code.

integer
help
required

Suggested next step.

string
reference
required

Support reference, e.g. MZ-502.

string
fault_code

Names the underlying condition, e.g. mail.NO_SUCH_FOLDER.

string | null
Examples

Unknown folder

{
  "error": "The mail server did not answer as expected, so this action could not be completed.",
  "status": 502,
  "help": "If the problem persists, contact support and inform the error code above.",
  "reference": "MZ-502",
  "fault_code": "mail.NO_SUCH_FOLDER"
}