sendraven-ai · Schema
Suppression
One suppressed address in one scope. The list and POST /v1/suppressions return this same object, with every field present.
CompanyEmailArtificial IntelligenceInfrastructure
Properties
| Name | Type | Description |
|---|---|---|
| id | string | |
| string | Trimmed and lower-cased. | |
| reason | string | hard_bounce and complaint are set by SendRaven (or a contact import) with scope all and are never replaced by a weaker reason, so after a POST this can differ from the reason sent. unsubscribe comes f |
| scope | string | Which mail the suppression blocks, matched against the message's risk class: all blocks everything, transactional only transactional mail, marketing only marketing mail (campaigns, automations and sen |
| detail | stringnull | The SMTP diagnostic for a bounce, the feedback type for a complaint, how someone unsubscribed, or the import it came from. null when there is none. Never set through this API. |
| created_at | string | When the address was first suppressed with this scope. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/sendraven-ai/json-schema/sendraven-ai-suppression-schema.json",
"title": "Suppression",
"description": "One suppressed address in one scope. The list and POST /v1/suppressions return this same object, with every field present.",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/sendraven-ai-suppressions-api-openapi.yml#/components/schemas/Suppression",
"type": "object",
"required": [
"id",
"email",
"reason",
"scope",
"detail",
"created_at"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"email": {
"type": "string",
"description": "Trimmed and lower-cased."
},
"reason": {
"type": "string",
"enum": [
"hard_bounce",
"complaint",
"unsubscribe",
"manual",
"list_hygiene"
],
"description": "hard_bounce and complaint are set by SendRaven (or a contact import) with scope all and are never replaced by a weaker reason, so after a POST this can differ from the reason sent. unsubscribe comes from unsubscribe links and the preference centre, with scope marketing. manual and list_hygiene are set by callers."
},
"scope": {
"type": "string",
"enum": [
"all",
"transactional",
"marketing"
],
"description": "Which mail the suppression blocks, matched against the message's risk class: all blocks everything, transactional only transactional mail, marketing only marketing mail (campaigns, automations and sends marked marketing). Use marketing for someone who asked to stop newsletters, so their password resets still arrive."
},
"detail": {
"type": [
"string",
"null"
],
"maxLength": 500,
"description": "The SMTP diagnostic for a bounce, the feedback type for a complaint, how someone unsubscribed, or the import it came from. null when there is none. Never set through this API."
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "When the address was first suppressed with this scope."
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/sendraven-ai-suppression"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.