Skip to content
Optiwork API Docs

Get a draft

GET
/mail/mailboxes/{mailbox}/drafts/{draftId}
curl --request GET \
  --url https://mail.work.optidata.cloud/api/mail/mailboxes/78/drafts/918 \
  --header 'Authorization: Bearer <token>'

Read a draft by its own id, with its attachments, ready to reopen in a compose window.

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.

draftId
required
integer

Id of the draft.

Responses

Section titled “ Responses ”

200

Section titled “200”

The draft.

Media typeapplication/json

A message being composed.

object
id
integer
mailbox_id
integer
type

How an outgoing message came to be.

string
Allowed values: new reply forward
status

Where a draft stands. not_sent is still being written, sending has been handed to the queue, sent has left, and failed could not be delivered.

string
Allowed values: not_sent sending sent failed
reply_server_message_id

The message this draft answers, when it answers one.

string | null
subject
string | null
body
string | null
date
string
is_read_receipt_enabled
boolean
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> | null

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> | null

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> | null

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
attachments

The files uploaded to the draft.

Array<object>
object
created_at
string
updated_at
string
Example
{
  "id": 918,
  "type": "new",
  "status": "not_sent",
  "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"
    }
  ]
}

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."
}

404

Section titled “404”

No such draft.

Media typeapplication/json

Acknowledgement returned by several write operations.

object
message
required
string
Examples
Examplemissing
{
  "message": "Draft not found."
}

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."
}