API referenceSuppressions

Add up to 100 suppressions

POST
/v1/suppressions/bulk

Authorization

bearerAuth
headerAuthorizationBearer <token>

API key sent as Authorization: Bearer <key>. Looked up by SHA-256 hash (email_core::sha256_hex) against api_keys.hash; revoked keys and keys belonging to a suspended tenant are rejected. See the top-level Authentication section for permission levels.

Request Body

application/json
  1. body
emails*array<>
Items1 <= items <= 100

Response Body

Per-email results (an invalid email is a per-item failure, not a batch abort).

application/json
  1. response
data?array<>
curl -X POST "https://example.com/v1/suppressions/bulk" \  -H "Content-Type: application/json" \  -d '{    "emails": [      {        "email": "user@example.com"      }    ]  }'
{  "data": [    {      "email": "string",      "status": "suppressed",      "error": "string"    }  ]}