Release an email
BillionSend extension: delivers a held message to the inbox. Mail held before screening ran (not_allowlisted, unauthenticated_sender, failed_auth) is screened first when screening can run, and stays held when the judge scores it at 80 or more (409 held_by_screening); otherwise it is never screened again. trust_sender also adds the sender to the allowlist, only for mail held as not_allowlisted from a verified (external) sender. MCP connections release for an agent: never mail held for prompt injection, phishing, a virus or failed authentication (403 forbidden), and any other hold only once screening, run at every MCP release, scores it under 80; while screening can’t run, nothing is released (503 screening_unavailable). Not for inbox-scoped keys.
/inboxes/{inbox_id}/quarantine/{email_id}/releaseAuthorizationToken Bearer · headerobrigatórioA BillionSend API key (bs_…).
inbox_idstringobrigatórioThe inbox ID or its email address, such as support@example.com
email_idstring<uuid>obrigatórioThe received email's ID
application/jsontrust_senderbooleanAlso add the sender's address to the inbox allowlist
Released
objectstringobrigatórioinbox_releaseinbox_idstring<uuid>obrigatórioemail_idstring<uuid>obrigatórioreleased_atstringobrigatóriotrusted_senderstring | nullobrigatórioMissing, malformed, unknown or revoked API key
statusCodenumberobrigatórionamestringobrigatóriomessagestringobrigatórioRestricted API key, trust_sender refused, or an MCP connection releasing mail held for its content
statusCodenumberobrigatórionamestringobrigatóriomessagestringobrigatórioNot found or not quarantined
statusCodenumberobrigatórionamestringobrigatóriomessagestringobrigatórioScreening held it again: it stays in quarantine
statusCodenumberobrigatórionamestringobrigatóriomessagestringobrigatórioValidation error, or the allowlist is full
statusCodenumberobrigatórionamestringobrigatóriomessagestringobrigatórioOver the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumberobrigatórionamestringobrigatóriomessagestringobrigatórioAn MCP connection's release while screening can't run; retry-after says when to try again
statusCodenumberobrigatórionamestringobrigatóriomessagestringobrigatório