SendcorexDocs

Quarantine

Release Email

Releases a quarantined email for delivery. The body and subject are sanitized before being sent. Each quarantine_id can only be released once.

POSThttps://mail.sendcorex.com/v3.0/quarantine/release
i

Where does the ID come from? When /send flags a message, it returns 403 with a quarantine_id. See My messages are flagged as spam.

!

Limits: a quarantine record expires after 3 hours, and releases are capped at 10 per 3 hours. Going over the cap returns RELEASE_LIMIT_REACHED and the account goes under review. Review the content before you release.

Body parameters

  • quarantine_idstringrequired

    The ID returned in the 403 response from /send when the email was flagged.

    e.g. "qtn_3f2a1b4c8e9d4f7a"

What happens on release

  1. 1

    Lookup

    The quarantine record is fetched and validated against your account. Records belonging to other accounts are rejected.

  2. 2

    Sanitize

    The body and subject are sanitized to strip any remaining harmful patterns before delivery.

  3. 3

    Ingest

    Each recipient in the original payload gets an individual email record prepared and dispatched via the internal ingest pipeline.

  4. 4

    Mark released

    The quarantine record is marked as released: true and the release counter is incremented. Subsequent calls with the same ID are rejected.

Because the body and subject are sanitized, the delivered email can differ from the one you originally sent.

Quick start

import axios from 'axios';

const quarantineId = 'qtn_3f2a1b4c8e9d4f7a';

const response = await axios.post(
  'https://mail.sendcorex.com/v3.0/quarantine/release',
  { quarantine_id: quarantineId },
  { headers: { Authorization: process.env.SENDCOREX_API_KEY } }
);

const { success, released, recipients } = response.data;
console.log(`Released to ${recipients} recipient(s)`);

Response

{
  "success": true,
  "released": true,
  "code": "QUARANTINE_RELEASED",
  "quarantine_id": "qtn_3f2a1b4c8e9d4f7a",
  "recipients": 1
}

Errors

All error codes →

Errors return a JSON object with error, code and responseTime.

  • 401MISSING_AUTH_HEADER

    No Authorization header present.

  • 401INVALID_API_KEY

    The API key is invalid or revoked.

  • 401ACCOUNT_BLOCKED

    Account has been blocked.

  • 401NO_CREDITS_LEFT

    No email credits remaining.

  • 401USER_NOT_FOUND

    User not found.

  • 401MISSING_USER_PRIVILEGES

    Missing user privileges.

  • 401EMAIL_CREDITS_NOT_FOUND

    Error fetching email credits.

  • 429CREDENTIAL_TEMPORARILY_BLOCKED

    API key temporarily blocked due to repeated policy violations.

  • 429IP_TEMPORARILY_BLOCKED

    Requesting IP temporarily blocked due to repeated policy violations.

  • 400MISSING_QUARANTINE_ID

    quarantine_id is required.

  • 403RELEASE_LIMIT_REACHED

    Too many quarantine releases (limit: 10 / 3h). Account under review.

  • 403QUARANTINE_FORBIDDEN

    The quarantine record belongs to another account.

  • 404QUARANTINE_NOT_FOUND

    Quarantine record not found or already processed.

  • 410QUARANTINE_EXPIRED

    Quarantine record has expired. Please resend the email.

  • 500INTERNAL_SERVER_ERROR

    Unexpected server error. Try again.

  • 500QUARANTINE_CORRUPT

    Corrupt quarantine payload.