---
search:
  tags:
    - Inboxes
    - POST
seo:
  description: >-
    BillionSend extension: delivers a held message to… Reference for the POST
    /inboxes/{inbox_id}/quarantine/{email_id}/release endpoint in the
    BillionSend API.
sidebar:
  label: Release an email
  badge: POST
title: Release an email
type: openapi-operation
---
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.

`POST /inboxes/{inbox_id}/quarantine/{email_id}/release`

**Request body** (`application/json`)

- `trust_sender` (boolean) — Also add the sender's address to the inbox allowlist

Request body example:

```json
{
  "trust_sender": true
}
```

**Responses**

- `200` — Released
- `401` — Missing, malformed, unknown or revoked API key
- `403` — Restricted API key, trust\_sender refused, or an MCP connection releasing mail held for its content
- `404` — Not found or not quarantined
- `409` — Screening held it again: it stays in quarantine
- `422` — Validation error, or the allowlist is full
- `429` — Over the rate limit (rate\_limit\_exceeded, with Retry-After)
- `503` — An MCP connection's release while screening can't run; retry-after says when to try again

Response example, 200:

```json
{
  "object": "inbox_release",
  "inbox_id": "5127f22b-d152-46dd-aeaa-3a852d9fbfc2",
  "email_id": "8e6bf5ae-e456-4654-87f8-33e2156caffc",
  "released_at": "string",
  "trusted_sender": "string"
}
```
