Release a quarantined message
Delivers a quarantined message into the thread it would have joined and publishes one `mailbox.message.released` event.
POST
Delivers a quarantined message into the thread it would have joined and publishes one mailbox.message.released event. Releasing it again returns the same result and publishes nothing. Only a person can release; API keys never hold quarantine.release. Isolated (malware) messages and discarded messages cannot be released: 409.
apiKeyheader
x-api-key<token>id*stringMatch
^mbx_[0-9a-hjkmnp-tv-z]{16,24}$messageId*stringMatch
^msg_[0-9a-hjkmnp-tv-z]{16,24}$MailboxQuarantinedMessage
application/json- response
id*MessageIdMatch
^msg_[0-9a-hjkmnp-tv-z]{16,24}$disposition*stringValue in
"quarantined""isolated"reason*stringValue in
"spam""dmarc""virus""virus_unscanned""phishing""fraud""prompt_injection"source*stringValue in
"receipt""classifier"from*subject*string|nullreceivedAt*stringheldAt*stringreleasedAt*string|nullthreadId*|nulldiscardedAt*string|nullimport { createClient } from "samva";
const samva = createClient({ apiKey: process.env.SAMVA_API_KEY! });
const result = await samva.mailboxes.releaseMessage({
"id": "example",
"messageId": "example"
});Example Response
{
"id": "string",
"disposition": "quarantined",
"reason": "spam",
"source": "receipt",
"from": {
"address": "string",
"name": "string"
},
"subject": "string",
"receivedAt": "string",
"heldAt": "string",
"releasedAt": "string",
"threadId": "string",
"discardedAt": "string"
}