Skip to content
Optiwork API Docs

Get a quarantined message

GET
/mail/mailboxes/{mailbox}/spam/{spamMessageId}/latest
curl --request GET \
  --url https://mail.work.optidata.cloud/api/mail/mailboxes/78/spam/eyJkb21haW4iOiJhY21lLmV4YW1wbGUiLCJ1aWQiOjR9/latest \
  --header 'Authorization: Bearer <token>'

The same quarantined message as the reader operation, returned as a single object instead of a one-element array.

Requires the spam feature to be enabled for the tenant.

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.

spamMessageId
required
string

Opaque id of a quarantined message, exactly as returned by the quarantine listing.

Responses

Section titled “ Responses ”

200

Section titled “200”

The quarantined message.

Media typeapplication/json

A quarantined message with its content expanded.

object
id
string
uid
string | integer | null
subject
string | null
from
string | null
from_name
string | null
to
string | null
cc
array | object | null
bcc
array | object | null
reply_to
array | object | null
date
string | null
text_plain
string | null
text_html
string | null
is_seen
boolean
is_answered
boolean
is_deleted
boolean
is_draft
boolean
size
integer
headers
string | null
has_attachments
boolean
Examplegenerated
{
  "id": "example",
  "uid": "example",
  "subject": "example",
  "from": "example",
  "from_name": "example",
  "to": "example",
  "cc": [
    "example"
  ],
  "bcc": [
    "example"
  ],
  "reply_to": [
    "example"
  ],
  "date": "example",
  "text_plain": "example",
  "text_html": "example",
  "is_seen": true,
  "is_answered": true,
  "is_deleted": true,
  "is_draft": true,
  "size": 1,
  "headers": "example",
  "has_attachments": true
}

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 spam features are not enabled for this tenant.

Media typeapplication/json

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

object
message
required

Human-readable description of the failure.

string
Examples
Exampledisabled
{
  "message": "Not available"
}

404

Section titled “404”

No quarantined message with that id.

Media typeapplication/json
Array
Examples
Examplemissing
[]

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