BRAINIAC Email & Communication Security is an MCP server published by software.brainiac, hosted at www.brainiac.software. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 8 tools, including email-security_header-forensics, email-security_spoofing-detect, email-security_phishing-signal-detect, email-security_bec-pattern-detect, email-security_domain-impersonation-check.
Paid Email & Communication Security API via x402. Unpaid tool calls return 402.
1,066 connections through 4 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Analyze caller-supplied email headers for routing hops and suspicious inconsistencies (From/Return-Path/Reply-To, auth results, dates) before you trust or release an email. Indicators only—not confirmed malice. Call with optional text, eml, headers, json, csv, file and others. Returns checkedAt, itemCount, items, paidProviderUsed, apiKeyRequired, externalScannerUsed, emailSent. HTTP 200 with status complete, partial, or failed is charged at the full listed price. HTTP 4xx/5xx are not charged. Keywords: before you trust or release an email, text, eml, headers, csv, file, files, emails, attachments, urls, urlHops, brandDomains, companyNames, conversations, authenticationResults.
| Parameter | Type | Description |
|---|---|---|
| csv | string | csv, string, length 0 to 200000. Optional. |
| eml | string | eml, string, length 0 to 500000. Optional. |
| asOf | string | asOf, string, length 0 to 40. Optional. |
| file | object | file, object. Optional. |
| json | string | json, string, length 0 to 200000. Optional. |
| text | string | text, string, length 0 to 500000. Optional. |
| urls | array | urls, array. Optional. |
| files | array | files, array. Optional. |
| emails | array | emails, array. Optional. |
| headers | string | headers, string, length 0 to 200000. Optional. |
| urlHops | array | urlHops, array. Optional. |
| publicDns | boolean | publicDns, boolean. Optional. |
| attachments | array | attachments, array. Optional. |
| brandDomains | array | brandDomains, array. Optional. |
| companyNames | array | companyNames, array. Optional. |
| conversations | array | conversations, array. Optional. |
| dkimSelectors | array | dkimSelectors, array. Optional. |
| followPublicUrls | boolean | followPublicUrls, boolean. Optional. |
| authenticationResults | object | authenticationResults, object. Optional. |
{
"name": "email-security_header-forensics",
"title": "Analyze email headers",
"description": "Analyze caller-supplied email headers for routing hops and suspicious inconsistencies (From/Return-Path/Reply-To, auth results, dates) before you trust or release an email. Indicators only—not confirmed malice. Call with optional text, eml, headers, json, csv, file and others. Returns checkedAt, itemCount, items, paidProviderUsed, apiKeyRequired, externalScannerUsed, emailSent. HTTP 200 with status complete, partial, or failed is charged at the full listed price. HTTP 4xx/5xx are not charged. Keywords: before you trust or release an email, text, eml, headers, csv, file, files, emails, attachments, urls, urlHops, brandDomains, companyNames, conversations, authenticationResults.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"csv": {
"type": "string",
"maxLength": 200000,
"description": "csv, string, length 0 to 200000. Optional."
},
"eml": {
"type": "string",
"maxLength": 500000,
"description": "eml, string, length 0 to 500000. Optional."
},
"asOf": {
"type": "string",
"maxLength": 40,
"description": "asOf, string, length 0 to 40. Optional."
},
"file": {
"type": "object",
"required": [
"fileBase64"
],
"properties": {
"role": {
"type": "string",
"maxLength": 80,
"description": "role, string, length 0 to 80. Optional."
},
"filename": {
"type": "string",
"maxLength": 180,
"minLength": 1,
"description": "filename, string, length 1 to 180. Optional."
},
"mediaType": {
"enum": [
"text/plain",
"message/rfc822",
"text/csv",
"application/json",
"application/octet-stream",
"application/pdf",
"application/zip"
],
"type": "string",
"description": "mediaType, string, one of text/plain, message/rfc822, text/csv, application/json, application/octet-stream, application/pdf. Optional."
},
"fileBase64": {
"type": "string",
"maxLength": 12000000,
"minLength": 1,
"description": "fileBase64, string, length 1 to 12000000. Required."
}
},
"description": "file, object. Optional."
},
"json": {
"type": "string",
"maxLength": 200000,
"description": "json, string, length 0 to 200000. Optional."
},
"text": {
"type": "string",
"maxLength": 500000,
"description": "text, string, length 0 to 500000. Optional."
},
"urls": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000,
"description": "item, string, length 0 to 2000. Required."
},
"description": "urls, array. Optional."
},
"files": {
"type": "array",
"items": {
"type": "object",
"required": [
"fileBase64"
],
"properties": {
"role": {
"type": "string",
"maxLength": 80,
"description": "role, string, length 0 to 80. Optional."
},
"filename": {
"type": "string",
"maxLength": 180,
"minLength": 1,
"description": "filename, string, length 1 to 180. Optional."
},
"mediaType": {
"enum": [
"text/plain",
"message/rfc822",
"text/csv",
"application/json",
"application/octet-stream",
"application/pdf",
"application/zip"
],
"type": "string",
"description": "mediaType, string, one of text/plain, message/rfc822, text/csv, application/json, application/octet-stream, application/pdf. Optional."
},
"fileBase64": {
"type": "string",
"maxLength": 12000000,
"minLength": 1,
"description": "fileBase64, string, length 1 to 12000000. Required."
}
},
"description": "item, object. Required."
},
"description": "files, array. Optional."
},
"emails": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cc": {
"type": "string",
"maxLength": 2000,
"description": "cc, string, length 0 to 2000. Optional."
},
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"to": {
"type": "string",
"maxLength": 2000,
"description": "to, string, length 0 to 2000. Optional."
},
"raw": {
"type": "string",
"maxLength": 500000,
"description": "raw, string, length 0 to 500000. Optional."
},
"date": {
"type": "string",
"maxLength": 80,
"description": "date, string, length 0 to 80. Optional."
},
"from": {
"type": "string",
"maxLength": 500,
"description": "from, string, length 0 to 500. Optional."
},
"urls": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000,
"description": "item, string, length 0 to 2000. Required."
},
"description": "urls, array. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"headers": {
"type": "string",
"maxLength": 200000,
"description": "headers, string, length 0 to 200000. Optional."
},
"replyTo": {
"type": "string",
"maxLength": 500,
"description": "replyTo, string, length 0 to 500. Optional."
},
"subject": {
"type": "string",
"maxLength": 998,
"description": "subject, string, length 0 to 998. Optional."
},
"bodyHtml": {
"type": "string",
"maxLength": 200000,
"description": "bodyHtml, string, length 0 to 200000. Optional."
},
"bodyText": {
"type": "string",
"maxLength": 200000,
"description": "bodyText, string, length 0 to 200000. Optional."
},
"inReplyTo": {
"type": "string",
"maxLength": 300,
"description": "inReplyTo, string, length 0 to 300. Optional."
},
"messageId": {
"type": "string",
"maxLength": 300,
"description": "messageId, string, length 0 to 300. Optional."
},
"references": {
"type": "string",
"maxLength": 4000,
"description": "references, string, length 0 to 4000. Optional."
},
"returnPath": {
"type": "string",
"maxLength": 500,
"description": "returnPath, string, length 0 to 500. Optional."
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"sha256": {
"type": "string",
"maxLength": 128,
"description": "sha256, string, length 0 to 128. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"filename": {
"type": "string",
"maxLength": 260,
"description": "filename, string, length 0 to 260. Optional."
},
"mediaType": {
"type": "string",
"maxLength": 120,
"description": "mediaType, string, length 0 to 120. Optional."
},
"sizeBytes": {
"type": "number",
"maximum": 100000000,
"minimum": 0,
"description": "sizeBytes, number, from 0 to 100000000. Optional."
},
"contentBase64": {
"type": "string",
"maxLength": 12000000,
"description": "contentBase64, string, length 0 to 12000000. Optional."
}
},
"description": "item, object. Required."
},
"description": "attachments, array. Optional."
},
"authenticationResults": {
"type": "object",
"properties": {
"spf": {
"enum": [
"pass",
"fail",
"softfail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "spf, string, one of pass, fail, softfail, neutral, none, temperror. Optional."
},
"dkim": {
"enum": [
"pass",
"fail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dkim, string, one of pass, fail, neutral, none, temperror, permerror. Optional."
},
"dmarc": {
"enum": [
"pass",
"fail",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dmarc, string, one of pass, fail, none, temperror, permerror, unknown. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
}
},
"description": "authenticationResults, object. Optional."
}
},
"description": "item, object. Required."
},
"description": "emails, array. Optional."
},
"headers": {
"type": "string",
"maxLength": 200000,
"description": "headers, string, length 0 to 200000. Optional."
},
"urlHops": {
"type": "array",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "url, string, length 1 to 2000. Required."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"status": {
"type": "number",
"maximum": 999,
"minimum": 0,
"description": "status, number, from 0 to 999. Optional."
},
"location": {
"type": "string",
"maxLength": 2000,
"description": "location, string, length 0 to 2000. Optional."
}
},
"description": "item, object. Required."
},
"description": "urlHops, array. Optional."
},
"publicDns": {
"type": "boolean",
"description": "publicDns, boolean. Optional."
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"sha256": {
"type": "string",
"maxLength": 128,
"description": "sha256, string, length 0 to 128. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"filename": {
"type": "string",
"maxLength": 260,
"description": "filename, string, length 0 to 260. Optional."
},
"mediaType": {
"type": "string",
"maxLength": 120,
"description": "mediaType, string, length 0 to 120. Optional."
},
"sizeBytes": {
"type": "number",
"maximum": 100000000,
"minimum": 0,
"description": "sizeBytes, number, from 0 to 100000000. Optional."
},
"contentBase64": {
"type": "string",
"maxLength": 12000000,
"description": "contentBase64, string, length 0 to 12000000. Optional."
}
},
"description": "item, object. Required."
},
"description": "attachments, array. Optional."
},
"brandDomains": {
"type": "array",
"items": {
"type": "string",
"maxLength": 253,
"description": "item, string, length 0 to 253. Required."
},
"description": "brandDomains, array. Optional."
},
"companyNames": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"description": "item, string, length 0 to 200. Required."
},
"description": "companyNames, array. Optional."
},
"conversations": {
"type": "array",
"items": {
"type": "object",
"required": [
"emails"
],
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"label": {
"type": "string",
"maxLength": 120,
"description": "label, string, length 0 to 120. Optional."
},
"emails": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cc": {
"type": "string",
"maxLength": 2000,
"description": "cc, string, length 0 to 2000. Optional."
},
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"to": {
"type": "string",
"maxLength": 2000,
"description": "to, string, length 0 to 2000. Optional."
},
"raw": {
"type": "string",
"maxLength": 500000,
"description": "raw, string, length 0 to 500000. Optional."
},
"date": {
"type": "string",
"maxLength": 80,
"description": "date, string, length 0 to 80. Optional."
},
"from": {
"type": "string",
"maxLength": 500,
"description": "from, string, length 0 to 500. Optional."
},
"urls": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000,
"description": "item, string, length 0 to 2000. Required."
},
"description": "urls, array. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"headers": {
"type": "string",
"maxLength": 200000,
"description": "headers, string, length 0 to 200000. Optional."
},
"replyTo": {
"type": "string",
"maxLength": 500,
"description": "replyTo, string, length 0 to 500. Optional."
},
"subject": {
"type": "string",
"maxLength": 998,
"description": "subject, string, length 0 to 998. Optional."
},
"bodyHtml": {
"type": "string",
"maxLength": 200000,
"description": "bodyHtml, string, length 0 to 200000. Optional."
},
"bodyText": {
"type": "string",
"maxLength": 200000,
"description": "bodyText, string, length 0 to 200000. Optional."
},
"inReplyTo": {
"type": "string",
"maxLength": 300,
"description": "inReplyTo, string, length 0 to 300. Optional."
},
"messageId": {
"type": "string",
"maxLength": 300,
"description": "messageId, string, length 0 to 300. Optional."
},
"references": {
"type": "string",
"maxLength": 4000,
"description": "references, string, length 0 to 4000. Optional."
},
"returnPath": {
"type": "string",
"maxLength": 500,
"description": "returnPath, string, length 0 to 500. Optional."
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"sha256": {
"type": "string",
"maxLength": 128,
"description": "sha256, string, length 0 to 128. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"filename": {
"type": "string",
"maxLength": 260,
"description": "filename, string, length 0 to 260. Optional."
},
"mediaType": {
"type": "string",
"maxLength": 120,
"description": "mediaType, string, length 0 to 120. Optional."
},
"sizeBytes": {
"type": "number",
"maximum": 100000000,
"minimum": 0,
"description": "sizeBytes, number, from 0 to 100000000. Optional."
},
"contentBase64": {
"type": "string",
"maxLength": 12000000,
"description": "contentBase64, string, length 0 to 12000000. Optional."
}
},
"description": "item, object. Required."
},
"description": "attachments, array. Optional."
},
"authenticationResults": {
"type": "object",
"properties": {
"spf": {
"enum": [
"pass",
"fail",
"softfail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "spf, string, one of pass, fail, softfail, neutral, none, temperror. Optional."
},
"dkim": {
"enum": [
"pass",
"fail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dkim, string, one of pass, fail, neutral, none, temperror, permerror. Optional."
},
"dmarc": {
"enum": [
"pass",
"fail",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dmarc, string, one of pass, fail, none, temperror, permerror, unknown. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
}
},
"description": "authenticationResults, object. Optional."
}
},
"description": "item, object. Required."
},
"description": "emails, array. Required."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
}
},
"description": "item, object. Required."
},
"description": "conversations, array. Optional."
},
"dkimSelectors": {
"type": "array",
"items": {
"type": "string",
"maxLength": 63,
"minLength": 1,
"description": "item, string, length 1 to 63. Required."
},
"description": "dkimSelectors, array. Optional."
},
"followPublicUrls": {
"type": "boolean",
"description": "followPublicUrls, boolean. Optional."
},
"authenticationResults": {
"type": "object",
"properties": {
"spf": {
"enum": [
"pass",
"fail",
"softfail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "spf, string, one of pass, fail, softfail, neutral, none, temperror. Optional."
},
"dkim": {
"enum": [
"pass",
"fail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dkim, string, one of pass, fail, neutral, none, temperror, permerror. Optional."
},
"dmarc": {
"enum": [
"pass",
"fail",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dmarc, string, one of pass, fail, none, temperror, permerror, unknown. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
}
},
"description": "authenticationResults, object. Optional."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "id. String."
},
"title": {
"type": "string",
"description": "title. String."
},
"source": {
"type": "string",
"description": "source. String."
},
"status": {
"type": "string",
"description": "status. String."
},
"reasons": {
"type": "array",
"items": {
"type": "string",
"description": "Item. String."
},
"description": "reasons. Array."
},
"detector": {
"type": "string",
"description": "detector. String."
},
"evidence": {
"type": "array",
"items": {
"type": "object",
"properties": {
"fact": {
"type": "string",
"description": "fact. String."
},
"subject": {
"type": "string",
"description": "subject. String."
},
"confidence": {
"type": "string",
"description": "confidence. String."
}
},
"description": "item. Object.",
"additionalProperties": {}
},
"description": "evidence. Array."
},
"confidence": {
"type": "string",
"description": "confidence. String."
},
"relatedIds": {
"type": "array",
"items": {
"type": "string",
"description": "Item. String."
},
"description": "relatedIds. Array."
},
"observedFacts": {
"type": "array",
"items": {
"type": "string",
"description": "Item. String."
},
"description": "observedFacts. Array."
},
"inferredThreat": {
"type": "string",
"description": "inferredThreat. String."
},
"confirmedMalicious": {
"type": "boolean",
"description": "confirmedMalicious. Boolean."
}
},
"description": "item. Object.",
"additionalProperties": {}
},
"description": "items. Array."
},
"status": {
"type": "string",
"description": "status. String."
},
"findings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "code. String."
},
"kind": {
"type": "string",
"description": "kind. String."
},
"detail": {
"type": "string",
"description": "detail. String."
},
"subject": {
"type": "string",
"description": "subject. String."
}
},
"description": "item. Object.",
"additionalProperties": {}
},
"description": "findings. Array."
},
"checkedAt": {
"type": "string",
"description": "checkedAt. String."
},
"emailSent": {
"type": "boolean",
"description": "emailSent. Boolean."
},
"itemCount": {
"type": "number",
"description": "itemCount. Number."
},
"limitations": {
"type": "array",
"items": {
"type": "string",
"description": "Item. String."
},
"description": "limitations. Array."
},
"apiKeyRequired": {
"type": "boolean",
"description": "apiKeyRequired. Boolean."
},
"paidProviderUsed": {
"type": "boolean",
"description": "paidProviderUsed. Boolean."
},
"publicDnsQueried": {
"type": "boolean",
"description": "publicDnsQueried. Boolean."
},
"publicUrlsFollowed": {
"type": "boolean",
"description": "publicUrlsFollowed. Boolean."
},
"externalScannerUsed": {
"type": "boolean",
"description": "externalScannerUsed. Boolean."
},
"confirmedMaliciousClaimed": {
"type": "boolean",
"description": "confirmedMaliciousClaimed. Boolean."
},
"attachmentUploadedExternally": {
"type": "boolean",
"description": "attachmentUploadedExternally. Boolean."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Analyze email headers",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Detect sender spoofing indicators from supplied SPF/DKIM/DMARC authentication results and optional public DNS TXT evidence before you trust or release an email. Not a confirmed spoof verdict without multi-signal evidence. Call with optional text, eml, headers, json, csv, file and others. HTTP 200 with status complete, partial, or failed is charged at the full listed price. HTTP 4xx/5xx are not charged. Keywords: before you trust or release an email, text, eml, headers, csv, file, files, emails, attachments, urls, urlHops, brandDomains, companyNames, conversations, authenticationResults.
| Parameter | Type | Description |
|---|---|---|
| csv | string | csv, string, length 0 to 200000. Optional. |
| eml | string | eml, string, length 0 to 500000. Optional. |
| asOf | string | asOf, string, length 0 to 40. Optional. |
| file | object | file, object. Optional. |
| json | string | json, string, length 0 to 200000. Optional. |
| text | string | text, string, length 0 to 500000. Optional. |
| urls | array | urls, array. Optional. |
| files | array | files, array. Optional. |
| emails | array |
Identify phishing indicators in caller-supplied email content and URLs (urgency phrases, lookalike hosts, IP URLs, password forms) before you trust or release an email. Indicators are not confirmed malicious activity. Call with optional text, eml, headers, json, csv, file and others. HTTP 200 with status complete, partial, or failed is charged at the full listed price. HTTP 4xx/5xx are not charged. Keywords: before you trust or release an email, text, eml, headers, csv, file, files, emails, attachments, urls, urlHops, brandDomains, companyNames, conversations, authenticationResults.
| Parameter | Type | Description |
|---|---|---|
| csv | string | csv, string, length 0 to 200000. Optional. |
| eml | string | eml, string, length 0 to 500000. Optional. |
| asOf | string | asOf, string, length 0 to 40. Optional. |
| file | object | file, object. Optional. |
| json | string | json, string, length 0 to 200000. Optional. |
| text | string | text, string, length 0 to 500000. Optional. |
| urls | array | urls, array. Optional. |
| files | array | files, array. Optional. |
| emails | array |
Detect Business Email Compromise patterns such as payment-change language, executive persona cues, external Reply-To, and lookalike sender domains from supplied mail before you trust or release an email. Call with optional text, eml, headers, json, csv, file and others. Returns checkedAt, itemCount, items, paidProviderUsed, apiKeyRequired, externalScannerUsed, emailSent. HTTP 200 with status complete, partial, or failed is charged at the full listed price. HTTP 4xx/5xx are not charged. Keywords: before you trust or release an email, text, eml, headers, csv, file, files, emails, attachments, urls, urlHops, brandDomains, companyNames, conversations, authenticationResults.
| Parameter | Type | Description |
|---|---|---|
| csv | string | csv, string, length 0 to 200000. Optional. |
| eml | string | eml, string, length 0 to 500000. Optional. |
| asOf | string | asOf, string, length 0 to 40. Optional. |
| file | object | file, object. Optional. |
| json | string | json, string, length 0 to 200000. Optional. |
| text | string | text, string, length 0 to 500000. Optional. |
| urls | array | urls, array. Optional. |
| files | array | files, array. Optional. |
| emails |
Identify domains resembling supplied company or brand domains using edit distance, hyphen variants, homoglyph folding, and brand-token embedding before you trust or release an email. Resemblance is not proof of abuse. Call with optional text, eml, headers, json, csv, file and others. HTTP 200 with status complete, partial, or failed is charged at the full listed price. HTTP 4xx/5xx are not charged. Keywords: before you trust or release an email, text, eml, headers, csv, file, files, emails, attachments, urls, urlHops, brandDomains, companyNames, conversations, authenticationResults.
| Parameter | Type | Description |
|---|---|---|
| csv | string | csv, string, length 0 to 200000. Optional. |
| eml | string | eml, string, length 0 to 500000. Optional. |
| asOf | string | asOf, string, length 0 to 40. Optional. |
| file | object | file, object. Optional. |
| json | string | json, string, length 0 to 200000. Optional. |
| text | string | text, string, length 0 to 500000. Optional. |
| urls | array | urls, array. Optional. |
| files | array | files, array. Optional. |
| emails | array |
Analyze caller-supplied redirect hops or optionally follow public URLs with strict SSRF protections before you trust or release an email. Never sends email content to external scanners. Call with optional text, eml, headers, json, csv, file and others. Returns checkedAt, chainCount, items, chains, paidProviderUsed, apiKeyRequired, externalScannerUsed, emailSent. HTTP 200 with status complete, partial, or failed is charged at the full listed price. HTTP 4xx/5xx are not charged. Keywords: before you trust or release an email, text, eml, headers, csv, file, files, emails, attachments, urls, urlHops, brandDomains, companyNames, conversations, authenticationResults.
| Parameter | Type | Description |
|---|---|---|
| csv | string | csv, string, length 0 to 200000. Optional. |
| eml | string | eml, string, length 0 to 500000. Optional. |
| asOf | string | asOf, string, length 0 to 40. Optional. |
| file | object | file, object. Optional. |
| json | string | json, string, length 0 to 200000. Optional. |
| text | string | text, string, length 0 to 500000. Optional. |
| urls | array | urls, array. Optional. |
| files | array | files, array. Optional. |
| emails |
Inspect caller-supplied attachment filenames, metadata, and local magic-byte structures for suspicious patterns before you trust or release an email. No external sandbox or scanner is used. Call with optional text, eml, headers, json, csv, file and others. Returns checkedAt, itemCount, items, paidProviderUsed, apiKeyRequired, externalScannerUsed, emailSent. HTTP 200 with status complete, partial, or failed is charged at the full listed price. HTTP 4xx/5xx are not charged. Keywords: before you trust or release an email, text, eml, headers, csv, file, files, emails, attachments, urls, urlHops, brandDomains, companyNames, conversations, authenticationResults.
| Parameter | Type | Description |
|---|---|---|
| csv | string | csv, string, length 0 to 200000. Optional. |
| eml | string | eml, string, length 0 to 500000. Optional. |
| asOf | string | asOf, string, length 0 to 40. Optional. |
| file | object | file, object. Optional. |
| json | string | json, string, length 0 to 200000. Optional. |
| text | string | text, string, length 0 to 500000. Optional. |
| urls | array | urls, array. Optional. |
| files | array | files, array. Optional. |
| emails |
Identify inconsistencies between supplied email conversation copies (missing messages, body hash mismatches, header field divergence) before you trust or release an email. Export artifacts are distinguished from confirmed tampering. Call with optional text, eml, headers, json, csv, file and others. HTTP 200 with status complete, partial, or failed is charged at the full listed price. HTTP 4xx/5xx are not charged. Keywords: before you trust or release an email, text, eml, headers, csv, file, files, emails, attachments, urls, urlHops, brandDomains, companyNames, conversations, authenticationResults.
| Parameter | Type | Description |
|---|---|---|
| csv | string | csv, string, length 0 to 200000. Optional. |
| eml | string | eml, string, length 0 to 500000. Optional. |
| asOf | string | asOf, string, length 0 to 40. Optional. |
| file | object | file, object. Optional. |
| json | string | json, string, length 0 to 200000. Optional. |
| text | string | text, string, length 0 to 500000. Optional. |
| urls | array | urls, array. Optional. |
| files | array | files, array. Optional. |
| emails | array |
Tool calls wrap the existing POST APIs and stay pay-per-call. initialize and tools/list are free. An unpaid tool call returns the x402 payment terms in the tool result and does not run. Retry with the payment in params._meta["x402/payment"], or send payment-signature. Payment settles only after a successful result.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| emails, array. Optional. |
| headers | string | headers, string, length 0 to 200000. Optional. |
| urlHops | array | urlHops, array. Optional. |
| publicDns | boolean | publicDns, boolean. Optional. |
| attachments | array | attachments, array. Optional. |
| brandDomains | array | brandDomains, array. Optional. |
| companyNames | array | companyNames, array. Optional. |
| conversations | array | conversations, array. Optional. |
| dkimSelectors | array | dkimSelectors, array. Optional. |
| followPublicUrls | boolean | followPublicUrls, boolean. Optional. |
| authenticationResults | object | authenticationResults, object. Optional. |
{
"name": "email-security_spoofing-detect",
"title": "Detect email spoofing indicators",
"description": "Detect sender spoofing indicators from supplied SPF/DKIM/DMARC authentication results and optional public DNS TXT evidence before you trust or release an email. Not a confirmed spoof verdict without multi-signal evidence. Call with optional text, eml, headers, json, csv, file and others. HTTP 200 with status complete, partial, or failed is charged at the full listed price. HTTP 4xx/5xx are not charged. Keywords: before you trust or release an email, text, eml, headers, csv, file, files, emails, attachments, urls, urlHops, brandDomains, companyNames, conversations, authenticationResults.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"csv": {
"type": "string",
"maxLength": 200000,
"description": "csv, string, length 0 to 200000. Optional."
},
"eml": {
"type": "string",
"maxLength": 500000,
"description": "eml, string, length 0 to 500000. Optional."
},
"asOf": {
"type": "string",
"maxLength": 40,
"description": "asOf, string, length 0 to 40. Optional."
},
"file": {
"type": "object",
"required": [
"fileBase64"
],
"properties": {
"role": {
"type": "string",
"maxLength": 80,
"description": "role, string, length 0 to 80. Optional."
},
"filename": {
"type": "string",
"maxLength": 180,
"minLength": 1,
"description": "filename, string, length 1 to 180. Optional."
},
"mediaType": {
"enum": [
"text/plain",
"message/rfc822",
"text/csv",
"application/json",
"application/octet-stream",
"application/pdf",
"application/zip"
],
"type": "string",
"description": "mediaType, string, one of text/plain, message/rfc822, text/csv, application/json, application/octet-stream, application/pdf. Optional."
},
"fileBase64": {
"type": "string",
"maxLength": 12000000,
"minLength": 1,
"description": "fileBase64, string, length 1 to 12000000. Required."
}
},
"description": "file, object. Optional."
},
"json": {
"type": "string",
"maxLength": 200000,
"description": "json, string, length 0 to 200000. Optional."
},
"text": {
"type": "string",
"maxLength": 500000,
"description": "text, string, length 0 to 500000. Optional."
},
"urls": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000,
"description": "item, string, length 0 to 2000. Required."
},
"description": "urls, array. Optional."
},
"files": {
"type": "array",
"items": {
"type": "object",
"required": [
"fileBase64"
],
"properties": {
"role": {
"type": "string",
"maxLength": 80,
"description": "role, string, length 0 to 80. Optional."
},
"filename": {
"type": "string",
"maxLength": 180,
"minLength": 1,
"description": "filename, string, length 1 to 180. Optional."
},
"mediaType": {
"enum": [
"text/plain",
"message/rfc822",
"text/csv",
"application/json",
"application/octet-stream",
"application/pdf",
"application/zip"
],
"type": "string",
"description": "mediaType, string, one of text/plain, message/rfc822, text/csv, application/json, application/octet-stream, application/pdf. Optional."
},
"fileBase64": {
"type": "string",
"maxLength": 12000000,
"minLength": 1,
"description": "fileBase64, string, length 1 to 12000000. Required."
}
},
"description": "item, object. Required."
},
"description": "files, array. Optional."
},
"emails": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cc": {
"type": "string",
"maxLength": 2000,
"description": "cc, string, length 0 to 2000. Optional."
},
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"to": {
"type": "string",
"maxLength": 2000,
"description": "to, string, length 0 to 2000. Optional."
},
"raw": {
"type": "string",
"maxLength": 500000,
"description": "raw, string, length 0 to 500000. Optional."
},
"date": {
"type": "string",
"maxLength": 80,
"description": "date, string, length 0 to 80. Optional."
},
"from": {
"type": "string",
"maxLength": 500,
"description": "from, string, length 0 to 500. Optional."
},
"urls": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000,
"description": "item, string, length 0 to 2000. Required."
},
"description": "urls, array. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"headers": {
"type": "string",
"maxLength": 200000,
"description": "headers, string, length 0 to 200000. Optional."
},
"replyTo": {
"type": "string",
"maxLength": 500,
"description": "replyTo, string, length 0 to 500. Optional."
},
"subject": {
"type": "string",
"maxLength": 998,
"description": "subject, string, length 0 to 998. Optional."
},
"bodyHtml": {
"type": "string",
"maxLength": 200000,
"description": "bodyHtml, string, length 0 to 200000. Optional."
},
"bodyText": {
"type": "string",
"maxLength": 200000,
"description": "bodyText, string, length 0 to 200000. Optional."
},
"inReplyTo": {
"type": "string",
"maxLength": 300,
"description": "inReplyTo, string, length 0 to 300. Optional."
},
"messageId": {
"type": "string",
"maxLength": 300,
"description": "messageId, string, length 0 to 300. Optional."
},
"references": {
"type": "string",
"maxLength": 4000,
"description": "references, string, length 0 to 4000. Optional."
},
"returnPath": {
"type": "string",
"maxLength": 500,
"description": "returnPath, string, length 0 to 500. Optional."
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"sha256": {
"type": "string",
"maxLength": 128,
"description": "sha256, string, length 0 to 128. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"filename": {
"type": "string",
"maxLength": 260,
"description": "filename, string, length 0 to 260. Optional."
},
"mediaType": {
"type": "string",
"maxLength": 120,
"description": "mediaType, string, length 0 to 120. Optional."
},
"sizeBytes": {
"type": "number",
"maximum": 100000000,
"minimum": 0,
"description": "sizeBytes, number, from 0 to 100000000. Optional."
},
"contentBase64": {
"type": "string",
"maxLength": 12000000,
"description": "contentBase64, string, length 0 to 12000000. Optional."
}
},
"description": "item, object. Required."
},
"description": "attachments, array. Optional."
},
"authenticationResults": {
"type": "object",
"properties": {
"spf": {
"enum": [
"pass",
"fail",
"softfail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "spf, string, one of pass, fail, softfail, neutral, none, temperror. Optional."
},
"dkim": {
"enum": [
"pass",
"fail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dkim, string, one of pass, fail, neutral, none, temperror, permerror. Optional."
},
"dmarc": {
"enum": [
"pass",
"fail",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dmarc, string, one of pass, fail, none, temperror, permerror, unknown. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
}
},
"description": "authenticationResults, object. Optional."
}
},
"description": "item, object. Required."
},
"description": "emails, array. Optional."
},
"headers": {
"type": "string",
"maxLength": 200000,
"description": "headers, string, length 0 to 200000. Optional."
},
"urlHops": {
"type": "array",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "url, string, length 1 to 2000. Required."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"status": {
"type": "number",
"maximum": 999,
"minimum": 0,
"description": "status, number, from 0 to 999. Optional."
},
"location": {
"type": "string",
"maxLength": 2000,
"description": "location, string, length 0 to 2000. Optional."
}
},
"description": "item, object. Required."
},
"description": "urlHops, array. Optional."
},
"publicDns": {
"type": "boolean",
"description": "publicDns, boolean. Optional."
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"sha256": {
"type": "string",
"maxLength": 128,
"description": "sha256, string, length 0 to 128. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"filename": {
"type": "string",
"maxLength": 260,
"description": "filename, string, length 0 to 260. Optional."
},
"mediaType": {
"type": "string",
"maxLength": 120,
"description": "mediaType, string, length 0 to 120. Optional."
},
"sizeBytes": {
"type": "number",
"maximum": 100000000,
"minimum": 0,
"description": "sizeBytes, number, from 0 to 100000000. Optional."
},
"contentBase64": {
"type": "string",
"maxLength": 12000000,
"description": "contentBase64, string, length 0 to 12000000. Optional."
}
},
"description": "item, object. Required."
},
"description": "attachments, array. Optional."
},
"brandDomains": {
"type": "array",
"items": {
"type": "string",
"maxLength": 253,
"description": "item, string, length 0 to 253. Required."
},
"description": "brandDomains, array. Optional."
},
"companyNames": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"description": "item, string, length 0 to 200. Required."
},
"description": "companyNames, array. Optional."
},
"conversations": {
"type": "array",
"items": {
"type": "object",
"required": [
"emails"
],
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"label": {
"type": "string",
"maxLength": 120,
"description": "label, string, length 0 to 120. Optional."
},
"emails": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cc": {
"type": "string",
"maxLength": 2000,
"description": "cc, string, length 0 to 2000. Optional."
},
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"to": {
"type": "string",
"maxLength": 2000,
"description": "to, string, length 0 to 2000. Optional."
},
"raw": {
"type": "string",
"maxLength": 500000,
"description": "raw, string, length 0 to 500000. Optional."
},
"date": {
"type": "string",
"maxLength": 80,
"description": "date, string, length 0 to 80. Optional."
},
"from": {
"type": "string",
"maxLength": 500,
"description": "from, string, length 0 to 500. Optional."
},
"urls": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000,
"description": "item, string, length 0 to 2000. Required."
},
"description": "urls, array. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"headers": {
"type": "string",
"maxLength": 200000,
"description": "headers, string, length 0 to 200000. Optional."
},
"replyTo": {
"type": "string",
"maxLength": 500,
"description": "replyTo, string, length 0 to 500. Optional."
},
"subject": {
"type": "string",
"maxLength": 998,
"description": "subject, string, length 0 to 998. Optional."
},
"bodyHtml": {
"type": "string",
"maxLength": 200000,
"description": "bodyHtml, string, length 0 to 200000. Optional."
},
"bodyText": {
"type": "string",
"maxLength": 200000,
"description": "bodyText, string, length 0 to 200000. Optional."
},
"inReplyTo": {
"type": "string",
"maxLength": 300,
"description": "inReplyTo, string, length 0 to 300. Optional."
},
"messageId": {
"type": "string",
"maxLength": 300,
"description": "messageId, string, length 0 to 300. Optional."
},
"references": {
"type": "string",
"maxLength": 4000,
"description": "references, string, length 0 to 4000. Optional."
},
"returnPath": {
"type": "string",
"maxLength": 500,
"description": "returnPath, string, length 0 to 500. Optional."
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"sha256": {
"type": "string",
"maxLength": 128,
"description": "sha256, string, length 0 to 128. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"filename": {
"type": "string",
"maxLength": 260,
"description": "filename, string, length 0 to 260. Optional."
},
"mediaType": {
"type": "string",
"maxLength": 120,
"description": "mediaType, string, length 0 to 120. Optional."
},
"sizeBytes": {
"type": "number",
"maximum": 100000000,
"minimum": 0,
"description": "sizeBytes, number, from 0 to 100000000. Optional."
},
"contentBase64": {
"type": "string",
"maxLength": 12000000,
"description": "contentBase64, string, length 0 to 12000000. Optional."
}
},
"description": "item, object. Required."
},
"description": "attachments, array. Optional."
},
"authenticationResults": {
"type": "object",
"properties": {
"spf": {
"enum": [
"pass",
"fail",
"softfail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "spf, string, one of pass, fail, softfail, neutral, none, temperror. Optional."
},
"dkim": {
"enum": [
"pass",
"fail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dkim, string, one of pass, fail, neutral, none, temperror, permerror. Optional."
},
"dmarc": {
"enum": [
"pass",
"fail",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dmarc, string, one of pass, fail, none, temperror, permerror, unknown. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
}
},
"description": "authenticationResults, object. Optional."
}
},
"description": "item, object. Required."
},
"description": "emails, array. Required."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
}
},
"description": "item, object. Required."
},
"description": "conversations, array. Optional."
},
"dkimSelectors": {
"type": "array",
"items": {
"type": "string",
"maxLength": 63,
"minLength": 1,
"description": "item, string, length 1 to 63. Required."
},
"description": "dkimSelectors, array. Optional."
},
"followPublicUrls": {
"type": "boolean",
"description": "followPublicUrls, boolean. Optional."
},
"authenticationResults": {
"type": "object",
"properties": {
"spf": {
"enum": [
"pass",
"fail",
"softfail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "spf, string, one of pass, fail, softfail, neutral, none, temperror. Optional."
},
"dkim": {
"enum": [
"pass",
"fail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dkim, string, one of pass, fail, neutral, none, temperror, permerror. Optional."
},
"dmarc": {
"enum": [
"pass",
"fail",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dmarc, string, one of pass, fail, none, temperror, permerror, unknown. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
}
},
"description": "authenticationResults, object. Optional."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "id. String."
},
"title": {
"type": "string",
"description": "title. String."
},
"source": {
"type": "string",
"description": "source. String."
},
"status": {
"type": "string",
"description": "status. String."
},
"reasons": {
"type": "array",
"items": {
"type": "string",
"description": "Item. String."
},
"description": "reasons. Array."
},
"detector": {
"type": "string",
"description": "detector. String."
},
"evidence": {
"type": "array",
"items": {
"type": "object",
"properties": {
"fact": {
"type": "string",
"description": "fact. String."
},
"subject": {
"type": "string",
"description": "subject. String."
},
"inference": {
"type": "string",
"description": "inference. String."
},
"confidence": {
"type": "string",
"description": "confidence. String."
}
},
"description": "item. Object.",
"additionalProperties": {}
},
"description": "evidence. Array."
},
"confidence": {
"type": "string",
"description": "confidence. String."
},
"relatedIds": {
"type": "array",
"items": {
"type": "string",
"description": "Item. String."
},
"description": "relatedIds. Array."
},
"observedFacts": {
"type": "array",
"items": {
"type": "string",
"description": "Item. String."
},
"description": "observedFacts. Array."
},
"inferredThreat": {
"type": "string",
"description": "inferredThreat. String."
},
"confirmedMalicious": {
"type": "boolean",
"description": "confirmedMalicious. Boolean."
}
},
"description": "item. Object.",
"additionalProperties": {}
},
"description": "items. Array."
},
"status": {
"type": "string",
"description": "status. String."
},
"findings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "code. String."
},
"kind": {
"type": "string",
"description": "kind. String."
},
"detail": {
"type": "string",
"description": "detail. String."
},
"subject": {
"type": "string",
"description": "subject. String."
}
},
"description": "item. Object.",
"additionalProperties": {}
},
"description": "findings. Array."
},
"checkedAt": {
"type": "string",
"description": "checkedAt. String."
},
"emailSent": {
"type": "boolean",
"description": "emailSent. Boolean."
},
"itemCount": {
"type": "number",
"description": "itemCount. Number."
},
"limitations": {
"type": "array",
"items": {
"type": "string",
"description": "Item. String."
},
"description": "limitations. Array."
},
"apiKeyRequired": {
"type": "boolean",
"description": "apiKeyRequired. Boolean."
},
"paidProviderUsed": {
"type": "boolean",
"description": "paidProviderUsed. Boolean."
},
"publicDnsQueried": {
"type": "boolean",
"description": "publicDnsQueried. Boolean."
},
"publicUrlsFollowed": {
"type": "boolean",
"description": "publicUrlsFollowed. Boolean."
},
"externalScannerUsed": {
"type": "boolean",
"description": "externalScannerUsed. Boolean."
},
"confirmedMaliciousClaimed": {
"type": "boolean",
"description": "confirmedMaliciousClaimed. Boolean."
},
"attachmentUploadedExternally": {
"type": "boolean",
"description": "attachmentUploadedExternally. Boolean."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Detect email spoofing indicators",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}| emails, array. Optional. |
| headers | string | headers, string, length 0 to 200000. Optional. |
| urlHops | array | urlHops, array. Optional. |
| publicDns | boolean | publicDns, boolean. Optional. |
| attachments | array | attachments, array. Optional. |
| brandDomains | array | brandDomains, array. Optional. |
| companyNames | array | companyNames, array. Optional. |
| conversations | array | conversations, array. Optional. |
| dkimSelectors | array | dkimSelectors, array. Optional. |
| followPublicUrls | boolean | followPublicUrls, boolean. Optional. |
| authenticationResults | object | authenticationResults, object. Optional. |
{
"name": "email-security_phishing-signal-detect",
"title": "Detect phishing signals",
"description": "Identify phishing indicators in caller-supplied email content and URLs (urgency phrases, lookalike hosts, IP URLs, password forms) before you trust or release an email. Indicators are not confirmed malicious activity. Call with optional text, eml, headers, json, csv, file and others. HTTP 200 with status complete, partial, or failed is charged at the full listed price. HTTP 4xx/5xx are not charged. Keywords: before you trust or release an email, text, eml, headers, csv, file, files, emails, attachments, urls, urlHops, brandDomains, companyNames, conversations, authenticationResults.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"csv": {
"type": "string",
"maxLength": 200000,
"description": "csv, string, length 0 to 200000. Optional."
},
"eml": {
"type": "string",
"maxLength": 500000,
"description": "eml, string, length 0 to 500000. Optional."
},
"asOf": {
"type": "string",
"maxLength": 40,
"description": "asOf, string, length 0 to 40. Optional."
},
"file": {
"type": "object",
"required": [
"fileBase64"
],
"properties": {
"role": {
"type": "string",
"maxLength": 80,
"description": "role, string, length 0 to 80. Optional."
},
"filename": {
"type": "string",
"maxLength": 180,
"minLength": 1,
"description": "filename, string, length 1 to 180. Optional."
},
"mediaType": {
"enum": [
"text/plain",
"message/rfc822",
"text/csv",
"application/json",
"application/octet-stream",
"application/pdf",
"application/zip"
],
"type": "string",
"description": "mediaType, string, one of text/plain, message/rfc822, text/csv, application/json, application/octet-stream, application/pdf. Optional."
},
"fileBase64": {
"type": "string",
"maxLength": 12000000,
"minLength": 1,
"description": "fileBase64, string, length 1 to 12000000. Required."
}
},
"description": "file, object. Optional."
},
"json": {
"type": "string",
"maxLength": 200000,
"description": "json, string, length 0 to 200000. Optional."
},
"text": {
"type": "string",
"maxLength": 500000,
"description": "text, string, length 0 to 500000. Optional."
},
"urls": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000,
"description": "item, string, length 0 to 2000. Required."
},
"description": "urls, array. Optional."
},
"files": {
"type": "array",
"items": {
"type": "object",
"required": [
"fileBase64"
],
"properties": {
"role": {
"type": "string",
"maxLength": 80,
"description": "role, string, length 0 to 80. Optional."
},
"filename": {
"type": "string",
"maxLength": 180,
"minLength": 1,
"description": "filename, string, length 1 to 180. Optional."
},
"mediaType": {
"enum": [
"text/plain",
"message/rfc822",
"text/csv",
"application/json",
"application/octet-stream",
"application/pdf",
"application/zip"
],
"type": "string",
"description": "mediaType, string, one of text/plain, message/rfc822, text/csv, application/json, application/octet-stream, application/pdf. Optional."
},
"fileBase64": {
"type": "string",
"maxLength": 12000000,
"minLength": 1,
"description": "fileBase64, string, length 1 to 12000000. Required."
}
},
"description": "item, object. Required."
},
"description": "files, array. Optional."
},
"emails": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cc": {
"type": "string",
"maxLength": 2000,
"description": "cc, string, length 0 to 2000. Optional."
},
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"to": {
"type": "string",
"maxLength": 2000,
"description": "to, string, length 0 to 2000. Optional."
},
"raw": {
"type": "string",
"maxLength": 500000,
"description": "raw, string, length 0 to 500000. Optional."
},
"date": {
"type": "string",
"maxLength": 80,
"description": "date, string, length 0 to 80. Optional."
},
"from": {
"type": "string",
"maxLength": 500,
"description": "from, string, length 0 to 500. Optional."
},
"urls": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000,
"description": "item, string, length 0 to 2000. Required."
},
"description": "urls, array. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"headers": {
"type": "string",
"maxLength": 200000,
"description": "headers, string, length 0 to 200000. Optional."
},
"replyTo": {
"type": "string",
"maxLength": 500,
"description": "replyTo, string, length 0 to 500. Optional."
},
"subject": {
"type": "string",
"maxLength": 998,
"description": "subject, string, length 0 to 998. Optional."
},
"bodyHtml": {
"type": "string",
"maxLength": 200000,
"description": "bodyHtml, string, length 0 to 200000. Optional."
},
"bodyText": {
"type": "string",
"maxLength": 200000,
"description": "bodyText, string, length 0 to 200000. Optional."
},
"inReplyTo": {
"type": "string",
"maxLength": 300,
"description": "inReplyTo, string, length 0 to 300. Optional."
},
"messageId": {
"type": "string",
"maxLength": 300,
"description": "messageId, string, length 0 to 300. Optional."
},
"references": {
"type": "string",
"maxLength": 4000,
"description": "references, string, length 0 to 4000. Optional."
},
"returnPath": {
"type": "string",
"maxLength": 500,
"description": "returnPath, string, length 0 to 500. Optional."
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"sha256": {
"type": "string",
"maxLength": 128,
"description": "sha256, string, length 0 to 128. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"filename": {
"type": "string",
"maxLength": 260,
"description": "filename, string, length 0 to 260. Optional."
},
"mediaType": {
"type": "string",
"maxLength": 120,
"description": "mediaType, string, length 0 to 120. Optional."
},
"sizeBytes": {
"type": "number",
"maximum": 100000000,
"minimum": 0,
"description": "sizeBytes, number, from 0 to 100000000. Optional."
},
"contentBase64": {
"type": "string",
"maxLength": 12000000,
"description": "contentBase64, string, length 0 to 12000000. Optional."
}
},
"description": "item, object. Required."
},
"description": "attachments, array. Optional."
},
"authenticationResults": {
"type": "object",
"properties": {
"spf": {
"enum": [
"pass",
"fail",
"softfail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "spf, string, one of pass, fail, softfail, neutral, none, temperror. Optional."
},
"dkim": {
"enum": [
"pass",
"fail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dkim, string, one of pass, fail, neutral, none, temperror, permerror. Optional."
},
"dmarc": {
"enum": [
"pass",
"fail",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dmarc, string, one of pass, fail, none, temperror, permerror, unknown. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
}
},
"description": "authenticationResults, object. Optional."
}
},
"description": "item, object. Required."
},
"description": "emails, array. Optional."
},
"headers": {
"type": "string",
"maxLength": 200000,
"description": "headers, string, length 0 to 200000. Optional."
},
"urlHops": {
"type": "array",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "url, string, length 1 to 2000. Required."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"status": {
"type": "number",
"maximum": 999,
"minimum": 0,
"description": "status, number, from 0 to 999. Optional."
},
"location": {
"type": "string",
"maxLength": 2000,
"description": "location, string, length 0 to 2000. Optional."
}
},
"description": "item, object. Required."
},
"description": "urlHops, array. Optional."
},
"publicDns": {
"type": "boolean",
"description": "publicDns, boolean. Optional."
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"sha256": {
"type": "string",
"maxLength": 128,
"description": "sha256, string, length 0 to 128. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"filename": {
"type": "string",
"maxLength": 260,
"description": "filename, string, length 0 to 260. Optional."
},
"mediaType": {
"type": "string",
"maxLength": 120,
"description": "mediaType, string, length 0 to 120. Optional."
},
"sizeBytes": {
"type": "number",
"maximum": 100000000,
"minimum": 0,
"description": "sizeBytes, number, from 0 to 100000000. Optional."
},
"contentBase64": {
"type": "string",
"maxLength": 12000000,
"description": "contentBase64, string, length 0 to 12000000. Optional."
}
},
"description": "item, object. Required."
},
"description": "attachments, array. Optional."
},
"brandDomains": {
"type": "array",
"items": {
"type": "string",
"maxLength": 253,
"description": "item, string, length 0 to 253. Required."
},
"description": "brandDomains, array. Optional."
},
"companyNames": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"description": "item, string, length 0 to 200. Required."
},
"description": "companyNames, array. Optional."
},
"conversations": {
"type": "array",
"items": {
"type": "object",
"required": [
"emails"
],
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"label": {
"type": "string",
"maxLength": 120,
"description": "label, string, length 0 to 120. Optional."
},
"emails": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cc": {
"type": "string",
"maxLength": 2000,
"description": "cc, string, length 0 to 2000. Optional."
},
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"to": {
"type": "string",
"maxLength": 2000,
"description": "to, string, length 0 to 2000. Optional."
},
"raw": {
"type": "string",
"maxLength": 500000,
"description": "raw, string, length 0 to 500000. Optional."
},
"date": {
"type": "string",
"maxLength": 80,
"description": "date, string, length 0 to 80. Optional."
},
"from": {
"type": "string",
"maxLength": 500,
"description": "from, string, length 0 to 500. Optional."
},
"urls": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000,
"description": "item, string, length 0 to 2000. Required."
},
"description": "urls, array. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"headers": {
"type": "string",
"maxLength": 200000,
"description": "headers, string, length 0 to 200000. Optional."
},
"replyTo": {
"type": "string",
"maxLength": 500,
"description": "replyTo, string, length 0 to 500. Optional."
},
"subject": {
"type": "string",
"maxLength": 998,
"description": "subject, string, length 0 to 998. Optional."
},
"bodyHtml": {
"type": "string",
"maxLength": 200000,
"description": "bodyHtml, string, length 0 to 200000. Optional."
},
"bodyText": {
"type": "string",
"maxLength": 200000,
"description": "bodyText, string, length 0 to 200000. Optional."
},
"inReplyTo": {
"type": "string",
"maxLength": 300,
"description": "inReplyTo, string, length 0 to 300. Optional."
},
"messageId": {
"type": "string",
"maxLength": 300,
"description": "messageId, string, length 0 to 300. Optional."
},
"references": {
"type": "string",
"maxLength": 4000,
"description": "references, string, length 0 to 4000. Optional."
},
"returnPath": {
"type": "string",
"maxLength": 500,
"description": "returnPath, string, length 0 to 500. Optional."
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"sha256": {
"type": "string",
"maxLength": 128,
"description": "sha256, string, length 0 to 128. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"filename": {
"type": "string",
"maxLength": 260,
"description": "filename, string, length 0 to 260. Optional."
},
"mediaType": {
"type": "string",
"maxLength": 120,
"description": "mediaType, string, length 0 to 120. Optional."
},
"sizeBytes": {
"type": "number",
"maximum": 100000000,
"minimum": 0,
"description": "sizeBytes, number, from 0 to 100000000. Optional."
},
"contentBase64": {
"type": "string",
"maxLength": 12000000,
"description": "contentBase64, string, length 0 to 12000000. Optional."
}
},
"description": "item, object. Required."
},
"description": "attachments, array. Optional."
},
"authenticationResults": {
"type": "object",
"properties": {
"spf": {
"enum": [
"pass",
"fail",
"softfail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "spf, string, one of pass, fail, softfail, neutral, none, temperror. Optional."
},
"dkim": {
"enum": [
"pass",
"fail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dkim, string, one of pass, fail, neutral, none, temperror, permerror. Optional."
},
"dmarc": {
"enum": [
"pass",
"fail",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dmarc, string, one of pass, fail, none, temperror, permerror, unknown. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
}
},
"description": "authenticationResults, object. Optional."
}
},
"description": "item, object. Required."
},
"description": "emails, array. Required."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
}
},
"description": "item, object. Required."
},
"description": "conversations, array. Optional."
},
"dkimSelectors": {
"type": "array",
"items": {
"type": "string",
"maxLength": 63,
"minLength": 1,
"description": "item, string, length 1 to 63. Required."
},
"description": "dkimSelectors, array. Optional."
},
"followPublicUrls": {
"type": "boolean",
"description": "followPublicUrls, boolean. Optional."
},
"authenticationResults": {
"type": "object",
"properties": {
"spf": {
"enum": [
"pass",
"fail",
"softfail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "spf, string, one of pass, fail, softfail, neutral, none, temperror. Optional."
},
"dkim": {
"enum": [
"pass",
"fail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dkim, string, one of pass, fail, neutral, none, temperror, permerror. Optional."
},
"dmarc": {
"enum": [
"pass",
"fail",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dmarc, string, one of pass, fail, none, temperror, permerror, unknown. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
}
},
"description": "authenticationResults, object. Optional."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "id. String."
},
"title": {
"type": "string",
"description": "title. String."
},
"source": {
"type": "string",
"description": "source. String."
},
"status": {
"type": "string",
"description": "status. String."
},
"reasons": {
"type": "array",
"items": {
"type": "string",
"description": "Item. String."
},
"description": "reasons. Array."
},
"detector": {
"type": "string",
"description": "detector. String."
},
"evidence": {
"type": "array",
"items": {
"type": "object",
"properties": {
"fact": {
"type": "string",
"description": "fact. String."
},
"subject": {
"type": "string",
"description": "subject. String."
},
"inference": {
"type": "string",
"description": "inference. String."
},
"confidence": {
"type": "string",
"description": "confidence. String."
}
},
"description": "item. Object.",
"additionalProperties": {}
},
"description": "evidence. Array."
},
"confidence": {
"type": "string",
"description": "confidence. String."
},
"relatedIds": {
"type": "array",
"items": {
"type": "string",
"description": "Item. String."
},
"description": "relatedIds. Array."
},
"observedFacts": {
"type": "array",
"items": {
"type": "string",
"description": "Item. String."
},
"description": "observedFacts. Array."
},
"inferredThreat": {
"type": "string",
"description": "inferredThreat. String."
},
"confirmedMalicious": {
"type": "boolean",
"description": "confirmedMalicious. Boolean."
}
},
"description": "item. Object.",
"additionalProperties": {}
},
"description": "items. Array."
},
"status": {
"type": "string",
"description": "status. String."
},
"findings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "code. String."
},
"kind": {
"type": "string",
"description": "kind. String."
},
"detail": {
"type": "string",
"description": "detail. String."
},
"subject": {
"type": "string",
"description": "subject. String."
}
},
"description": "item. Object.",
"additionalProperties": {}
},
"description": "findings. Array."
},
"checkedAt": {
"type": "string",
"description": "checkedAt. String."
},
"emailSent": {
"type": "boolean",
"description": "emailSent. Boolean."
},
"itemCount": {
"type": "number",
"description": "itemCount. Number."
},
"limitations": {
"type": "array",
"items": {
"type": "string",
"description": "Item. String."
},
"description": "limitations. Array."
},
"apiKeyRequired": {
"type": "boolean",
"description": "apiKeyRequired. Boolean."
},
"paidProviderUsed": {
"type": "boolean",
"description": "paidProviderUsed. Boolean."
},
"publicDnsQueried": {
"type": "boolean",
"description": "publicDnsQueried. Boolean."
},
"publicUrlsFollowed": {
"type": "boolean",
"description": "publicUrlsFollowed. Boolean."
},
"externalScannerUsed": {
"type": "boolean",
"description": "externalScannerUsed. Boolean."
},
"confirmedMaliciousClaimed": {
"type": "boolean",
"description": "confirmedMaliciousClaimed. Boolean."
},
"attachmentUploadedExternally": {
"type": "boolean",
"description": "attachmentUploadedExternally. Boolean."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Detect phishing signals",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}| array |
| emails, array. Optional. |
| headers | string | headers, string, length 0 to 200000. Optional. |
| urlHops | array | urlHops, array. Optional. |
| publicDns | boolean | publicDns, boolean. Optional. |
| attachments | array | attachments, array. Optional. |
| brandDomains | array | brandDomains, array. Optional. |
| companyNames | array | companyNames, array. Optional. |
| conversations | array | conversations, array. Optional. |
| dkimSelectors | array | dkimSelectors, array. Optional. |
| followPublicUrls | boolean | followPublicUrls, boolean. Optional. |
| authenticationResults | object | authenticationResults, object. Optional. |
{
"name": "email-security_bec-pattern-detect",
"title": "Detect BEC patterns",
"description": "Detect Business Email Compromise patterns such as payment-change language, executive persona cues, external Reply-To, and lookalike sender domains from supplied mail before you trust or release an email. Call with optional text, eml, headers, json, csv, file and others. Returns checkedAt, itemCount, items, paidProviderUsed, apiKeyRequired, externalScannerUsed, emailSent. HTTP 200 with status complete, partial, or failed is charged at the full listed price. HTTP 4xx/5xx are not charged. Keywords: before you trust or release an email, text, eml, headers, csv, file, files, emails, attachments, urls, urlHops, brandDomains, companyNames, conversations, authenticationResults.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"csv": {
"type": "string",
"maxLength": 200000,
"description": "csv, string, length 0 to 200000. Optional."
},
"eml": {
"type": "string",
"maxLength": 500000,
"description": "eml, string, length 0 to 500000. Optional."
},
"asOf": {
"type": "string",
"maxLength": 40,
"description": "asOf, string, length 0 to 40. Optional."
},
"file": {
"type": "object",
"required": [
"fileBase64"
],
"properties": {
"role": {
"type": "string",
"maxLength": 80,
"description": "role, string, length 0 to 80. Optional."
},
"filename": {
"type": "string",
"maxLength": 180,
"minLength": 1,
"description": "filename, string, length 1 to 180. Optional."
},
"mediaType": {
"enum": [
"text/plain",
"message/rfc822",
"text/csv",
"application/json",
"application/octet-stream",
"application/pdf",
"application/zip"
],
"type": "string",
"description": "mediaType, string, one of text/plain, message/rfc822, text/csv, application/json, application/octet-stream, application/pdf. Optional."
},
"fileBase64": {
"type": "string",
"maxLength": 12000000,
"minLength": 1,
"description": "fileBase64, string, length 1 to 12000000. Required."
}
},
"description": "file, object. Optional."
},
"json": {
"type": "string",
"maxLength": 200000,
"description": "json, string, length 0 to 200000. Optional."
},
"text": {
"type": "string",
"maxLength": 500000,
"description": "text, string, length 0 to 500000. Optional."
},
"urls": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000,
"description": "item, string, length 0 to 2000. Required."
},
"description": "urls, array. Optional."
},
"files": {
"type": "array",
"items": {
"type": "object",
"required": [
"fileBase64"
],
"properties": {
"role": {
"type": "string",
"maxLength": 80,
"description": "role, string, length 0 to 80. Optional."
},
"filename": {
"type": "string",
"maxLength": 180,
"minLength": 1,
"description": "filename, string, length 1 to 180. Optional."
},
"mediaType": {
"enum": [
"text/plain",
"message/rfc822",
"text/csv",
"application/json",
"application/octet-stream",
"application/pdf",
"application/zip"
],
"type": "string",
"description": "mediaType, string, one of text/plain, message/rfc822, text/csv, application/json, application/octet-stream, application/pdf. Optional."
},
"fileBase64": {
"type": "string",
"maxLength": 12000000,
"minLength": 1,
"description": "fileBase64, string, length 1 to 12000000. Required."
}
},
"description": "item, object. Required."
},
"description": "files, array. Optional."
},
"emails": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cc": {
"type": "string",
"maxLength": 2000,
"description": "cc, string, length 0 to 2000. Optional."
},
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"to": {
"type": "string",
"maxLength": 2000,
"description": "to, string, length 0 to 2000. Optional."
},
"raw": {
"type": "string",
"maxLength": 500000,
"description": "raw, string, length 0 to 500000. Optional."
},
"date": {
"type": "string",
"maxLength": 80,
"description": "date, string, length 0 to 80. Optional."
},
"from": {
"type": "string",
"maxLength": 500,
"description": "from, string, length 0 to 500. Optional."
},
"urls": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000,
"description": "item, string, length 0 to 2000. Required."
},
"description": "urls, array. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"headers": {
"type": "string",
"maxLength": 200000,
"description": "headers, string, length 0 to 200000. Optional."
},
"replyTo": {
"type": "string",
"maxLength": 500,
"description": "replyTo, string, length 0 to 500. Optional."
},
"subject": {
"type": "string",
"maxLength": 998,
"description": "subject, string, length 0 to 998. Optional."
},
"bodyHtml": {
"type": "string",
"maxLength": 200000,
"description": "bodyHtml, string, length 0 to 200000. Optional."
},
"bodyText": {
"type": "string",
"maxLength": 200000,
"description": "bodyText, string, length 0 to 200000. Optional."
},
"inReplyTo": {
"type": "string",
"maxLength": 300,
"description": "inReplyTo, string, length 0 to 300. Optional."
},
"messageId": {
"type": "string",
"maxLength": 300,
"description": "messageId, string, length 0 to 300. Optional."
},
"references": {
"type": "string",
"maxLength": 4000,
"description": "references, string, length 0 to 4000. Optional."
},
"returnPath": {
"type": "string",
"maxLength": 500,
"description": "returnPath, string, length 0 to 500. Optional."
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"sha256": {
"type": "string",
"maxLength": 128,
"description": "sha256, string, length 0 to 128. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"filename": {
"type": "string",
"maxLength": 260,
"description": "filename, string, length 0 to 260. Optional."
},
"mediaType": {
"type": "string",
"maxLength": 120,
"description": "mediaType, string, length 0 to 120. Optional."
},
"sizeBytes": {
"type": "number",
"maximum": 100000000,
"minimum": 0,
"description": "sizeBytes, number, from 0 to 100000000. Optional."
},
"contentBase64": {
"type": "string",
"maxLength": 12000000,
"description": "contentBase64, string, length 0 to 12000000. Optional."
}
},
"description": "item, object. Required."
},
"description": "attachments, array. Optional."
},
"authenticationResults": {
"type": "object",
"properties": {
"spf": {
"enum": [
"pass",
"fail",
"softfail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "spf, string, one of pass, fail, softfail, neutral, none, temperror. Optional."
},
"dkim": {
"enum": [
"pass",
"fail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dkim, string, one of pass, fail, neutral, none, temperror, permerror. Optional."
},
"dmarc": {
"enum": [
"pass",
"fail",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dmarc, string, one of pass, fail, none, temperror, permerror, unknown. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
}
},
"description": "authenticationResults, object. Optional."
}
},
"description": "item, object. Required."
},
"description": "emails, array. Optional."
},
"headers": {
"type": "string",
"maxLength": 200000,
"description": "headers, string, length 0 to 200000. Optional."
},
"urlHops": {
"type": "array",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "url, string, length 1 to 2000. Required."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"status": {
"type": "number",
"maximum": 999,
"minimum": 0,
"description": "status, number, from 0 to 999. Optional."
},
"location": {
"type": "string",
"maxLength": 2000,
"description": "location, string, length 0 to 2000. Optional."
}
},
"description": "item, object. Required."
},
"description": "urlHops, array. Optional."
},
"publicDns": {
"type": "boolean",
"description": "publicDns, boolean. Optional."
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"sha256": {
"type": "string",
"maxLength": 128,
"description": "sha256, string, length 0 to 128. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"filename": {
"type": "string",
"maxLength": 260,
"description": "filename, string, length 0 to 260. Optional."
},
"mediaType": {
"type": "string",
"maxLength": 120,
"description": "mediaType, string, length 0 to 120. Optional."
},
"sizeBytes": {
"type": "number",
"maximum": 100000000,
"minimum": 0,
"description": "sizeBytes, number, from 0 to 100000000. Optional."
},
"contentBase64": {
"type": "string",
"maxLength": 12000000,
"description": "contentBase64, string, length 0 to 12000000. Optional."
}
},
"description": "item, object. Required."
},
"description": "attachments, array. Optional."
},
"brandDomains": {
"type": "array",
"items": {
"type": "string",
"maxLength": 253,
"description": "item, string, length 0 to 253. Required."
},
"description": "brandDomains, array. Optional."
},
"companyNames": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"description": "item, string, length 0 to 200. Required."
},
"description": "companyNames, array. Optional."
},
"conversations": {
"type": "array",
"items": {
"type": "object",
"required": [
"emails"
],
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"label": {
"type": "string",
"maxLength": 120,
"description": "label, string, length 0 to 120. Optional."
},
"emails": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cc": {
"type": "string",
"maxLength": 2000,
"description": "cc, string, length 0 to 2000. Optional."
},
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"to": {
"type": "string",
"maxLength": 2000,
"description": "to, string, length 0 to 2000. Optional."
},
"raw": {
"type": "string",
"maxLength": 500000,
"description": "raw, string, length 0 to 500000. Optional."
},
"date": {
"type": "string",
"maxLength": 80,
"description": "date, string, length 0 to 80. Optional."
},
"from": {
"type": "string",
"maxLength": 500,
"description": "from, string, length 0 to 500. Optional."
},
"urls": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000,
"description": "item, string, length 0 to 2000. Required."
},
"description": "urls, array. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"headers": {
"type": "string",
"maxLength": 200000,
"description": "headers, string, length 0 to 200000. Optional."
},
"replyTo": {
"type": "string",
"maxLength": 500,
"description": "replyTo, string, length 0 to 500. Optional."
},
"subject": {
"type": "string",
"maxLength": 998,
"description": "subject, string, length 0 to 998. Optional."
},
"bodyHtml": {
"type": "string",
"maxLength": 200000,
"description": "bodyHtml, string, length 0 to 200000. Optional."
},
"bodyText": {
"type": "string",
"maxLength": 200000,
"description": "bodyText, string, length 0 to 200000. Optional."
},
"inReplyTo": {
"type": "string",
"maxLength": 300,
"description": "inReplyTo, string, length 0 to 300. Optional."
},
"messageId": {
"type": "string",
"maxLength": 300,
"description": "messageId, string, length 0 to 300. Optional."
},
"references": {
"type": "string",
"maxLength": 4000,
"description": "references, string, length 0 to 4000. Optional."
},
"returnPath": {
"type": "string",
"maxLength": 500,
"description": "returnPath, string, length 0 to 500. Optional."
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"sha256": {
"type": "string",
"maxLength": 128,
"description": "sha256, string, length 0 to 128. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"filename": {
"type": "string",
"maxLength": 260,
"description": "filename, string, length 0 to 260. Optional."
},
"mediaType": {
"type": "string",
"maxLength": 120,
"description": "mediaType, string, length 0 to 120. Optional."
},
"sizeBytes": {
"type": "number",
"maximum": 100000000,
"minimum": 0,
"description": "sizeBytes, number, from 0 to 100000000. Optional."
},
"contentBase64": {
"type": "string",
"maxLength": 12000000,
"description": "contentBase64, string, length 0 to 12000000. Optional."
}
},
"description": "item, object. Required."
},
"description": "attachments, array. Optional."
},
"authenticationResults": {
"type": "object",
"properties": {
"spf": {
"enum": [
"pass",
"fail",
"softfail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "spf, string, one of pass, fail, softfail, neutral, none, temperror. Optional."
},
"dkim": {
"enum": [
"pass",
"fail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dkim, string, one of pass, fail, neutral, none, temperror, permerror. Optional."
},
"dmarc": {
"enum": [
"pass",
"fail",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dmarc, string, one of pass, fail, none, temperror, permerror, unknown. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
}
},
"description": "authenticationResults, object. Optional."
}
},
"description": "item, object. Required."
},
"description": "emails, array. Required."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
}
},
"description": "item, object. Required."
},
"description": "conversations, array. Optional."
},
"dkimSelectors": {
"type": "array",
"items": {
"type": "string",
"maxLength": 63,
"minLength": 1,
"description": "item, string, length 1 to 63. Required."
},
"description": "dkimSelectors, array. Optional."
},
"followPublicUrls": {
"type": "boolean",
"description": "followPublicUrls, boolean. Optional."
},
"authenticationResults": {
"type": "object",
"properties": {
"spf": {
"enum": [
"pass",
"fail",
"softfail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "spf, string, one of pass, fail, softfail, neutral, none, temperror. Optional."
},
"dkim": {
"enum": [
"pass",
"fail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dkim, string, one of pass, fail, neutral, none, temperror, permerror. Optional."
},
"dmarc": {
"enum": [
"pass",
"fail",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dmarc, string, one of pass, fail, none, temperror, permerror, unknown. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
}
},
"description": "authenticationResults, object. Optional."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "id. String."
},
"title": {
"type": "string",
"description": "title. String."
},
"source": {
"type": "string",
"description": "source. String."
},
"status": {
"type": "string",
"description": "status. String."
},
"reasons": {
"type": "array",
"items": {
"type": "string",
"description": "Item. String."
},
"description": "reasons. Array."
},
"detector": {
"type": "string",
"description": "detector. String."
},
"evidence": {
"type": "array",
"items": {
"type": "object",
"properties": {
"fact": {
"type": "string",
"description": "fact. String."
},
"subject": {
"type": "string",
"description": "subject. String."
},
"confidence": {
"type": "string",
"description": "confidence. String."
}
},
"description": "item. Object.",
"additionalProperties": {}
},
"description": "evidence. Array."
},
"confidence": {
"type": "string",
"description": "confidence. String."
},
"relatedIds": {
"type": "array",
"items": {
"type": "string",
"description": "Item. String."
},
"description": "relatedIds. Array."
},
"observedFacts": {
"type": "array",
"items": {
"type": "string",
"description": "Item. String."
},
"description": "observedFacts. Array."
},
"inferredThreat": {
"type": "string",
"description": "inferredThreat. String."
},
"confirmedMalicious": {
"type": "boolean",
"description": "confirmedMalicious. Boolean."
}
},
"description": "item. Object.",
"additionalProperties": {}
},
"description": "items. Array."
},
"status": {
"type": "string",
"description": "status. String."
},
"findings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "code. String."
},
"kind": {
"type": "string",
"description": "kind. String."
},
"detail": {
"type": "string",
"description": "detail. String."
},
"subject": {
"type": "string",
"description": "subject. String."
}
},
"description": "item. Object.",
"additionalProperties": {}
},
"description": "findings. Array."
},
"checkedAt": {
"type": "string",
"description": "checkedAt. String."
},
"emailSent": {
"type": "boolean",
"description": "emailSent. Boolean."
},
"itemCount": {
"type": "number",
"description": "itemCount. Number."
},
"limitations": {
"type": "array",
"items": {
"type": "string",
"description": "Item. String."
},
"description": "limitations. Array."
},
"apiKeyRequired": {
"type": "boolean",
"description": "apiKeyRequired. Boolean."
},
"paidProviderUsed": {
"type": "boolean",
"description": "paidProviderUsed. Boolean."
},
"publicDnsQueried": {
"type": "boolean",
"description": "publicDnsQueried. Boolean."
},
"publicUrlsFollowed": {
"type": "boolean",
"description": "publicUrlsFollowed. Boolean."
},
"externalScannerUsed": {
"type": "boolean",
"description": "externalScannerUsed. Boolean."
},
"confirmedMaliciousClaimed": {
"type": "boolean",
"description": "confirmedMaliciousClaimed. Boolean."
},
"attachmentUploadedExternally": {
"type": "boolean",
"description": "attachmentUploadedExternally. Boolean."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Detect BEC patterns",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}| emails, array. Optional. |
| headers | string | headers, string, length 0 to 200000. Optional. |
| urlHops | array | urlHops, array. Optional. |
| publicDns | boolean | publicDns, boolean. Optional. |
| attachments | array | attachments, array. Optional. |
| brandDomains | array | brandDomains, array. Optional. |
| companyNames | array | companyNames, array. Optional. |
| conversations | array | conversations, array. Optional. |
| dkimSelectors | array | dkimSelectors, array. Optional. |
| followPublicUrls | boolean | followPublicUrls, boolean. Optional. |
| authenticationResults | object | authenticationResults, object. Optional. |
{
"name": "email-security_domain-impersonation-check",
"title": "Check domain impersonation",
"description": "Identify domains resembling supplied company or brand domains using edit distance, hyphen variants, homoglyph folding, and brand-token embedding before you trust or release an email. Resemblance is not proof of abuse. Call with optional text, eml, headers, json, csv, file and others. HTTP 200 with status complete, partial, or failed is charged at the full listed price. HTTP 4xx/5xx are not charged. Keywords: before you trust or release an email, text, eml, headers, csv, file, files, emails, attachments, urls, urlHops, brandDomains, companyNames, conversations, authenticationResults.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"csv": {
"type": "string",
"maxLength": 200000,
"description": "csv, string, length 0 to 200000. Optional."
},
"eml": {
"type": "string",
"maxLength": 500000,
"description": "eml, string, length 0 to 500000. Optional."
},
"asOf": {
"type": "string",
"maxLength": 40,
"description": "asOf, string, length 0 to 40. Optional."
},
"file": {
"type": "object",
"required": [
"fileBase64"
],
"properties": {
"role": {
"type": "string",
"maxLength": 80,
"description": "role, string, length 0 to 80. Optional."
},
"filename": {
"type": "string",
"maxLength": 180,
"minLength": 1,
"description": "filename, string, length 1 to 180. Optional."
},
"mediaType": {
"enum": [
"text/plain",
"message/rfc822",
"text/csv",
"application/json",
"application/octet-stream",
"application/pdf",
"application/zip"
],
"type": "string",
"description": "mediaType, string, one of text/plain, message/rfc822, text/csv, application/json, application/octet-stream, application/pdf. Optional."
},
"fileBase64": {
"type": "string",
"maxLength": 12000000,
"minLength": 1,
"description": "fileBase64, string, length 1 to 12000000. Required."
}
},
"description": "file, object. Optional."
},
"json": {
"type": "string",
"maxLength": 200000,
"description": "json, string, length 0 to 200000. Optional."
},
"text": {
"type": "string",
"maxLength": 500000,
"description": "text, string, length 0 to 500000. Optional."
},
"urls": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000,
"description": "item, string, length 0 to 2000. Required."
},
"description": "urls, array. Optional."
},
"files": {
"type": "array",
"items": {
"type": "object",
"required": [
"fileBase64"
],
"properties": {
"role": {
"type": "string",
"maxLength": 80,
"description": "role, string, length 0 to 80. Optional."
},
"filename": {
"type": "string",
"maxLength": 180,
"minLength": 1,
"description": "filename, string, length 1 to 180. Optional."
},
"mediaType": {
"enum": [
"text/plain",
"message/rfc822",
"text/csv",
"application/json",
"application/octet-stream",
"application/pdf",
"application/zip"
],
"type": "string",
"description": "mediaType, string, one of text/plain, message/rfc822, text/csv, application/json, application/octet-stream, application/pdf. Optional."
},
"fileBase64": {
"type": "string",
"maxLength": 12000000,
"minLength": 1,
"description": "fileBase64, string, length 1 to 12000000. Required."
}
},
"description": "item, object. Required."
},
"description": "files, array. Optional."
},
"emails": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cc": {
"type": "string",
"maxLength": 2000,
"description": "cc, string, length 0 to 2000. Optional."
},
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"to": {
"type": "string",
"maxLength": 2000,
"description": "to, string, length 0 to 2000. Optional."
},
"raw": {
"type": "string",
"maxLength": 500000,
"description": "raw, string, length 0 to 500000. Optional."
},
"date": {
"type": "string",
"maxLength": 80,
"description": "date, string, length 0 to 80. Optional."
},
"from": {
"type": "string",
"maxLength": 500,
"description": "from, string, length 0 to 500. Optional."
},
"urls": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000,
"description": "item, string, length 0 to 2000. Required."
},
"description": "urls, array. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"headers": {
"type": "string",
"maxLength": 200000,
"description": "headers, string, length 0 to 200000. Optional."
},
"replyTo": {
"type": "string",
"maxLength": 500,
"description": "replyTo, string, length 0 to 500. Optional."
},
"subject": {
"type": "string",
"maxLength": 998,
"description": "subject, string, length 0 to 998. Optional."
},
"bodyHtml": {
"type": "string",
"maxLength": 200000,
"description": "bodyHtml, string, length 0 to 200000. Optional."
},
"bodyText": {
"type": "string",
"maxLength": 200000,
"description": "bodyText, string, length 0 to 200000. Optional."
},
"inReplyTo": {
"type": "string",
"maxLength": 300,
"description": "inReplyTo, string, length 0 to 300. Optional."
},
"messageId": {
"type": "string",
"maxLength": 300,
"description": "messageId, string, length 0 to 300. Optional."
},
"references": {
"type": "string",
"maxLength": 4000,
"description": "references, string, length 0 to 4000. Optional."
},
"returnPath": {
"type": "string",
"maxLength": 500,
"description": "returnPath, string, length 0 to 500. Optional."
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"sha256": {
"type": "string",
"maxLength": 128,
"description": "sha256, string, length 0 to 128. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"filename": {
"type": "string",
"maxLength": 260,
"description": "filename, string, length 0 to 260. Optional."
},
"mediaType": {
"type": "string",
"maxLength": 120,
"description": "mediaType, string, length 0 to 120. Optional."
},
"sizeBytes": {
"type": "number",
"maximum": 100000000,
"minimum": 0,
"description": "sizeBytes, number, from 0 to 100000000. Optional."
},
"contentBase64": {
"type": "string",
"maxLength": 12000000,
"description": "contentBase64, string, length 0 to 12000000. Optional."
}
},
"description": "item, object. Required."
},
"description": "attachments, array. Optional."
},
"authenticationResults": {
"type": "object",
"properties": {
"spf": {
"enum": [
"pass",
"fail",
"softfail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "spf, string, one of pass, fail, softfail, neutral, none, temperror. Optional."
},
"dkim": {
"enum": [
"pass",
"fail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dkim, string, one of pass, fail, neutral, none, temperror, permerror. Optional."
},
"dmarc": {
"enum": [
"pass",
"fail",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dmarc, string, one of pass, fail, none, temperror, permerror, unknown. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
}
},
"description": "authenticationResults, object. Optional."
}
},
"description": "item, object. Required."
},
"description": "emails, array. Optional."
},
"headers": {
"type": "string",
"maxLength": 200000,
"description": "headers, string, length 0 to 200000. Optional."
},
"urlHops": {
"type": "array",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "url, string, length 1 to 2000. Required."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"status": {
"type": "number",
"maximum": 999,
"minimum": 0,
"description": "status, number, from 0 to 999. Optional."
},
"location": {
"type": "string",
"maxLength": 2000,
"description": "location, string, length 0 to 2000. Optional."
}
},
"description": "item, object. Required."
},
"description": "urlHops, array. Optional."
},
"publicDns": {
"type": "boolean",
"description": "publicDns, boolean. Optional."
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"sha256": {
"type": "string",
"maxLength": 128,
"description": "sha256, string, length 0 to 128. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"filename": {
"type": "string",
"maxLength": 260,
"description": "filename, string, length 0 to 260. Optional."
},
"mediaType": {
"type": "string",
"maxLength": 120,
"description": "mediaType, string, length 0 to 120. Optional."
},
"sizeBytes": {
"type": "number",
"maximum": 100000000,
"minimum": 0,
"description": "sizeBytes, number, from 0 to 100000000. Optional."
},
"contentBase64": {
"type": "string",
"maxLength": 12000000,
"description": "contentBase64, string, length 0 to 12000000. Optional."
}
},
"description": "item, object. Required."
},
"description": "attachments, array. Optional."
},
"brandDomains": {
"type": "array",
"items": {
"type": "string",
"maxLength": 253,
"description": "item, string, length 0 to 253. Required."
},
"description": "brandDomains, array. Optional."
},
"companyNames": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"description": "item, string, length 0 to 200. Required."
},
"description": "companyNames, array. Optional."
},
"conversations": {
"type": "array",
"items": {
"type": "object",
"required": [
"emails"
],
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"label": {
"type": "string",
"maxLength": 120,
"description": "label, string, length 0 to 120. Optional."
},
"emails": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cc": {
"type": "string",
"maxLength": 2000,
"description": "cc, string, length 0 to 2000. Optional."
},
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"to": {
"type": "string",
"maxLength": 2000,
"description": "to, string, length 0 to 2000. Optional."
},
"raw": {
"type": "string",
"maxLength": 500000,
"description": "raw, string, length 0 to 500000. Optional."
},
"date": {
"type": "string",
"maxLength": 80,
"description": "date, string, length 0 to 80. Optional."
},
"from": {
"type": "string",
"maxLength": 500,
"description": "from, string, length 0 to 500. Optional."
},
"urls": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000,
"description": "item, string, length 0 to 2000. Required."
},
"description": "urls, array. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"headers": {
"type": "string",
"maxLength": 200000,
"description": "headers, string, length 0 to 200000. Optional."
},
"replyTo": {
"type": "string",
"maxLength": 500,
"description": "replyTo, string, length 0 to 500. Optional."
},
"subject": {
"type": "string",
"maxLength": 998,
"description": "subject, string, length 0 to 998. Optional."
},
"bodyHtml": {
"type": "string",
"maxLength": 200000,
"description": "bodyHtml, string, length 0 to 200000. Optional."
},
"bodyText": {
"type": "string",
"maxLength": 200000,
"description": "bodyText, string, length 0 to 200000. Optional."
},
"inReplyTo": {
"type": "string",
"maxLength": 300,
"description": "inReplyTo, string, length 0 to 300. Optional."
},
"messageId": {
"type": "string",
"maxLength": 300,
"description": "messageId, string, length 0 to 300. Optional."
},
"references": {
"type": "string",
"maxLength": 4000,
"description": "references, string, length 0 to 4000. Optional."
},
"returnPath": {
"type": "string",
"maxLength": 500,
"description": "returnPath, string, length 0 to 500. Optional."
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"sha256": {
"type": "string",
"maxLength": 128,
"description": "sha256, string, length 0 to 128. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"filename": {
"type": "string",
"maxLength": 260,
"description": "filename, string, length 0 to 260. Optional."
},
"mediaType": {
"type": "string",
"maxLength": 120,
"description": "mediaType, string, length 0 to 120. Optional."
},
"sizeBytes": {
"type": "number",
"maximum": 100000000,
"minimum": 0,
"description": "sizeBytes, number, from 0 to 100000000. Optional."
},
"contentBase64": {
"type": "string",
"maxLength": 12000000,
"description": "contentBase64, string, length 0 to 12000000. Optional."
}
},
"description": "item, object. Required."
},
"description": "attachments, array. Optional."
},
"authenticationResults": {
"type": "object",
"properties": {
"spf": {
"enum": [
"pass",
"fail",
"softfail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "spf, string, one of pass, fail, softfail, neutral, none, temperror. Optional."
},
"dkim": {
"enum": [
"pass",
"fail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dkim, string, one of pass, fail, neutral, none, temperror, permerror. Optional."
},
"dmarc": {
"enum": [
"pass",
"fail",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dmarc, string, one of pass, fail, none, temperror, permerror, unknown. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
}
},
"description": "authenticationResults, object. Optional."
}
},
"description": "item, object. Required."
},
"description": "emails, array. Required."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
}
},
"description": "item, object. Required."
},
"description": "conversations, array. Optional."
},
"dkimSelectors": {
"type": "array",
"items": {
"type": "string",
"maxLength": 63,
"minLength": 1,
"description": "item, string, length 1 to 63. Required."
},
"description": "dkimSelectors, array. Optional."
},
"followPublicUrls": {
"type": "boolean",
"description": "followPublicUrls, boolean. Optional."
},
"authenticationResults": {
"type": "object",
"properties": {
"spf": {
"enum": [
"pass",
"fail",
"softfail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "spf, string, one of pass, fail, softfail, neutral, none, temperror. Optional."
},
"dkim": {
"enum": [
"pass",
"fail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dkim, string, one of pass, fail, neutral, none, temperror, permerror. Optional."
},
"dmarc": {
"enum": [
"pass",
"fail",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dmarc, string, one of pass, fail, none, temperror, permerror, unknown. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
}
},
"description": "authenticationResults, object. Optional."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "id. String."
},
"title": {
"type": "string",
"description": "title. String."
},
"source": {
"type": "string",
"description": "source. String."
},
"status": {
"type": "string",
"description": "status. String."
},
"reasons": {
"type": "array",
"items": {
"type": "string",
"description": "Item. String."
},
"description": "reasons. Array."
},
"detector": {
"type": "string",
"description": "detector. String."
},
"evidence": {
"type": "array",
"items": {
"type": "object",
"properties": {
"fact": {
"type": "string",
"description": "fact. String."
},
"subject": {
"type": "string",
"description": "subject. String."
},
"inference": {
"type": "string",
"description": "inference. String."
},
"confidence": {
"type": "string",
"description": "confidence. String."
}
},
"description": "item. Object.",
"additionalProperties": {}
},
"description": "evidence. Array."
},
"confidence": {
"type": "string",
"description": "confidence. String."
},
"relatedIds": {
"type": "array",
"items": {
"type": "string",
"description": "Item. String."
},
"description": "relatedIds. Array."
},
"observedFacts": {
"type": "array",
"items": {
"type": "string",
"description": "Item. String."
},
"description": "observedFacts. Array."
},
"inferredThreat": {
"type": "string",
"description": "inferredThreat. String."
},
"confirmedMalicious": {
"type": "boolean",
"description": "confirmedMalicious. Boolean."
}
},
"description": "item. Object.",
"additionalProperties": {}
},
"description": "items. Array."
},
"status": {
"type": "string",
"description": "status. String."
},
"findings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "code. String."
},
"kind": {
"type": "string",
"description": "kind. String."
},
"detail": {
"type": "string",
"description": "detail. String."
},
"subject": {
"type": "string",
"description": "subject. String."
}
},
"description": "item. Object.",
"additionalProperties": {}
},
"description": "findings. Array."
},
"checkedAt": {
"type": "string",
"description": "checkedAt. String."
},
"emailSent": {
"type": "boolean",
"description": "emailSent. Boolean."
},
"itemCount": {
"type": "number",
"description": "itemCount. Number."
},
"limitations": {
"type": "array",
"items": {
"type": "string",
"description": "Item. String."
},
"description": "limitations. Array."
},
"apiKeyRequired": {
"type": "boolean",
"description": "apiKeyRequired. Boolean."
},
"paidProviderUsed": {
"type": "boolean",
"description": "paidProviderUsed. Boolean."
},
"publicDnsQueried": {
"type": "boolean",
"description": "publicDnsQueried. Boolean."
},
"publicUrlsFollowed": {
"type": "boolean",
"description": "publicUrlsFollowed. Boolean."
},
"externalScannerUsed": {
"type": "boolean",
"description": "externalScannerUsed. Boolean."
},
"confirmedMaliciousClaimed": {
"type": "boolean",
"description": "confirmedMaliciousClaimed. Boolean."
},
"attachmentUploadedExternally": {
"type": "boolean",
"description": "attachmentUploadedExternally. Boolean."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Check domain impersonation",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}| array |
| emails, array. Optional. |
| headers | string | headers, string, length 0 to 200000. Optional. |
| urlHops | array | urlHops, array. Optional. |
| publicDns | boolean | publicDns, boolean. Optional. |
| attachments | array | attachments, array. Optional. |
| brandDomains | array | brandDomains, array. Optional. |
| companyNames | array | companyNames, array. Optional. |
| conversations | array | conversations, array. Optional. |
| dkimSelectors | array | dkimSelectors, array. Optional. |
| followPublicUrls | boolean | followPublicUrls, boolean. Optional. |
| authenticationResults | object | authenticationResults, object. Optional. |
{
"name": "email-security_url-chain-analyze",
"title": "Analyze email URL redirect chains",
"description": "Analyze caller-supplied redirect hops or optionally follow public URLs with strict SSRF protections before you trust or release an email. Never sends email content to external scanners. Call with optional text, eml, headers, json, csv, file and others. Returns checkedAt, chainCount, items, chains, paidProviderUsed, apiKeyRequired, externalScannerUsed, emailSent. HTTP 200 with status complete, partial, or failed is charged at the full listed price. HTTP 4xx/5xx are not charged. Keywords: before you trust or release an email, text, eml, headers, csv, file, files, emails, attachments, urls, urlHops, brandDomains, companyNames, conversations, authenticationResults.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"csv": {
"type": "string",
"maxLength": 200000,
"description": "csv, string, length 0 to 200000. Optional."
},
"eml": {
"type": "string",
"maxLength": 500000,
"description": "eml, string, length 0 to 500000. Optional."
},
"asOf": {
"type": "string",
"maxLength": 40,
"description": "asOf, string, length 0 to 40. Optional."
},
"file": {
"type": "object",
"required": [
"fileBase64"
],
"properties": {
"role": {
"type": "string",
"maxLength": 80,
"description": "role, string, length 0 to 80. Optional."
},
"filename": {
"type": "string",
"maxLength": 180,
"minLength": 1,
"description": "filename, string, length 1 to 180. Optional."
},
"mediaType": {
"enum": [
"text/plain",
"message/rfc822",
"text/csv",
"application/json",
"application/octet-stream",
"application/pdf",
"application/zip"
],
"type": "string",
"description": "mediaType, string, one of text/plain, message/rfc822, text/csv, application/json, application/octet-stream, application/pdf. Optional."
},
"fileBase64": {
"type": "string",
"maxLength": 12000000,
"minLength": 1,
"description": "fileBase64, string, length 1 to 12000000. Required."
}
},
"description": "file, object. Optional."
},
"json": {
"type": "string",
"maxLength": 200000,
"description": "json, string, length 0 to 200000. Optional."
},
"text": {
"type": "string",
"maxLength": 500000,
"description": "text, string, length 0 to 500000. Optional."
},
"urls": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000,
"description": "item, string, length 0 to 2000. Required."
},
"description": "urls, array. Optional."
},
"files": {
"type": "array",
"items": {
"type": "object",
"required": [
"fileBase64"
],
"properties": {
"role": {
"type": "string",
"maxLength": 80,
"description": "role, string, length 0 to 80. Optional."
},
"filename": {
"type": "string",
"maxLength": 180,
"minLength": 1,
"description": "filename, string, length 1 to 180. Optional."
},
"mediaType": {
"enum": [
"text/plain",
"message/rfc822",
"text/csv",
"application/json",
"application/octet-stream",
"application/pdf",
"application/zip"
],
"type": "string",
"description": "mediaType, string, one of text/plain, message/rfc822, text/csv, application/json, application/octet-stream, application/pdf. Optional."
},
"fileBase64": {
"type": "string",
"maxLength": 12000000,
"minLength": 1,
"description": "fileBase64, string, length 1 to 12000000. Required."
}
},
"description": "item, object. Required."
},
"description": "files, array. Optional."
},
"emails": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cc": {
"type": "string",
"maxLength": 2000,
"description": "cc, string, length 0 to 2000. Optional."
},
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"to": {
"type": "string",
"maxLength": 2000,
"description": "to, string, length 0 to 2000. Optional."
},
"raw": {
"type": "string",
"maxLength": 500000,
"description": "raw, string, length 0 to 500000. Optional."
},
"date": {
"type": "string",
"maxLength": 80,
"description": "date, string, length 0 to 80. Optional."
},
"from": {
"type": "string",
"maxLength": 500,
"description": "from, string, length 0 to 500. Optional."
},
"urls": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000,
"description": "item, string, length 0 to 2000. Required."
},
"description": "urls, array. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"headers": {
"type": "string",
"maxLength": 200000,
"description": "headers, string, length 0 to 200000. Optional."
},
"replyTo": {
"type": "string",
"maxLength": 500,
"description": "replyTo, string, length 0 to 500. Optional."
},
"subject": {
"type": "string",
"maxLength": 998,
"description": "subject, string, length 0 to 998. Optional."
},
"bodyHtml": {
"type": "string",
"maxLength": 200000,
"description": "bodyHtml, string, length 0 to 200000. Optional."
},
"bodyText": {
"type": "string",
"maxLength": 200000,
"description": "bodyText, string, length 0 to 200000. Optional."
},
"inReplyTo": {
"type": "string",
"maxLength": 300,
"description": "inReplyTo, string, length 0 to 300. Optional."
},
"messageId": {
"type": "string",
"maxLength": 300,
"description": "messageId, string, length 0 to 300. Optional."
},
"references": {
"type": "string",
"maxLength": 4000,
"description": "references, string, length 0 to 4000. Optional."
},
"returnPath": {
"type": "string",
"maxLength": 500,
"description": "returnPath, string, length 0 to 500. Optional."
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"sha256": {
"type": "string",
"maxLength": 128,
"description": "sha256, string, length 0 to 128. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"filename": {
"type": "string",
"maxLength": 260,
"description": "filename, string, length 0 to 260. Optional."
},
"mediaType": {
"type": "string",
"maxLength": 120,
"description": "mediaType, string, length 0 to 120. Optional."
},
"sizeBytes": {
"type": "number",
"maximum": 100000000,
"minimum": 0,
"description": "sizeBytes, number, from 0 to 100000000. Optional."
},
"contentBase64": {
"type": "string",
"maxLength": 12000000,
"description": "contentBase64, string, length 0 to 12000000. Optional."
}
},
"description": "item, object. Required."
},
"description": "attachments, array. Optional."
},
"authenticationResults": {
"type": "object",
"properties": {
"spf": {
"enum": [
"pass",
"fail",
"softfail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "spf, string, one of pass, fail, softfail, neutral, none, temperror. Optional."
},
"dkim": {
"enum": [
"pass",
"fail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dkim, string, one of pass, fail, neutral, none, temperror, permerror. Optional."
},
"dmarc": {
"enum": [
"pass",
"fail",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dmarc, string, one of pass, fail, none, temperror, permerror, unknown. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
}
},
"description": "authenticationResults, object. Optional."
}
},
"description": "item, object. Required."
},
"description": "emails, array. Optional."
},
"headers": {
"type": "string",
"maxLength": 200000,
"description": "headers, string, length 0 to 200000. Optional."
},
"urlHops": {
"type": "array",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "url, string, length 1 to 2000. Required."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"status": {
"type": "number",
"maximum": 999,
"minimum": 0,
"description": "status, number, from 0 to 999. Optional."
},
"location": {
"type": "string",
"maxLength": 2000,
"description": "location, string, length 0 to 2000. Optional."
}
},
"description": "item, object. Required."
},
"description": "urlHops, array. Optional."
},
"publicDns": {
"type": "boolean",
"description": "publicDns, boolean. Optional."
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"sha256": {
"type": "string",
"maxLength": 128,
"description": "sha256, string, length 0 to 128. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"filename": {
"type": "string",
"maxLength": 260,
"description": "filename, string, length 0 to 260. Optional."
},
"mediaType": {
"type": "string",
"maxLength": 120,
"description": "mediaType, string, length 0 to 120. Optional."
},
"sizeBytes": {
"type": "number",
"maximum": 100000000,
"minimum": 0,
"description": "sizeBytes, number, from 0 to 100000000. Optional."
},
"contentBase64": {
"type": "string",
"maxLength": 12000000,
"description": "contentBase64, string, length 0 to 12000000. Optional."
}
},
"description": "item, object. Required."
},
"description": "attachments, array. Optional."
},
"brandDomains": {
"type": "array",
"items": {
"type": "string",
"maxLength": 253,
"description": "item, string, length 0 to 253. Required."
},
"description": "brandDomains, array. Optional."
},
"companyNames": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"description": "item, string, length 0 to 200. Required."
},
"description": "companyNames, array. Optional."
},
"conversations": {
"type": "array",
"items": {
"type": "object",
"required": [
"emails"
],
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"label": {
"type": "string",
"maxLength": 120,
"description": "label, string, length 0 to 120. Optional."
},
"emails": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cc": {
"type": "string",
"maxLength": 2000,
"description": "cc, string, length 0 to 2000. Optional."
},
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"to": {
"type": "string",
"maxLength": 2000,
"description": "to, string, length 0 to 2000. Optional."
},
"raw": {
"type": "string",
"maxLength": 500000,
"description": "raw, string, length 0 to 500000. Optional."
},
"date": {
"type": "string",
"maxLength": 80,
"description": "date, string, length 0 to 80. Optional."
},
"from": {
"type": "string",
"maxLength": 500,
"description": "from, string, length 0 to 500. Optional."
},
"urls": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000,
"description": "item, string, length 0 to 2000. Required."
},
"description": "urls, array. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"headers": {
"type": "string",
"maxLength": 200000,
"description": "headers, string, length 0 to 200000. Optional."
},
"replyTo": {
"type": "string",
"maxLength": 500,
"description": "replyTo, string, length 0 to 500. Optional."
},
"subject": {
"type": "string",
"maxLength": 998,
"description": "subject, string, length 0 to 998. Optional."
},
"bodyHtml": {
"type": "string",
"maxLength": 200000,
"description": "bodyHtml, string, length 0 to 200000. Optional."
},
"bodyText": {
"type": "string",
"maxLength": 200000,
"description": "bodyText, string, length 0 to 200000. Optional."
},
"inReplyTo": {
"type": "string",
"maxLength": 300,
"description": "inReplyTo, string, length 0 to 300. Optional."
},
"messageId": {
"type": "string",
"maxLength": 300,
"description": "messageId, string, length 0 to 300. Optional."
},
"references": {
"type": "string",
"maxLength": 4000,
"description": "references, string, length 0 to 4000. Optional."
},
"returnPath": {
"type": "string",
"maxLength": 500,
"description": "returnPath, string, length 0 to 500. Optional."
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"sha256": {
"type": "string",
"maxLength": 128,
"description": "sha256, string, length 0 to 128. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"filename": {
"type": "string",
"maxLength": 260,
"description": "filename, string, length 0 to 260. Optional."
},
"mediaType": {
"type": "string",
"maxLength": 120,
"description": "mediaType, string, length 0 to 120. Optional."
},
"sizeBytes": {
"type": "number",
"maximum": 100000000,
"minimum": 0,
"description": "sizeBytes, number, from 0 to 100000000. Optional."
},
"contentBase64": {
"type": "string",
"maxLength": 12000000,
"description": "contentBase64, string, length 0 to 12000000. Optional."
}
},
"description": "item, object. Required."
},
"description": "attachments, array. Optional."
},
"authenticationResults": {
"type": "object",
"properties": {
"spf": {
"enum": [
"pass",
"fail",
"softfail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "spf, string, one of pass, fail, softfail, neutral, none, temperror. Optional."
},
"dkim": {
"enum": [
"pass",
"fail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dkim, string, one of pass, fail, neutral, none, temperror, permerror. Optional."
},
"dmarc": {
"enum": [
"pass",
"fail",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dmarc, string, one of pass, fail, none, temperror, permerror, unknown. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
}
},
"description": "authenticationResults, object. Optional."
}
},
"description": "item, object. Required."
},
"description": "emails, array. Required."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
}
},
"description": "item, object. Required."
},
"description": "conversations, array. Optional."
},
"dkimSelectors": {
"type": "array",
"items": {
"type": "string",
"maxLength": 63,
"minLength": 1,
"description": "item, string, length 1 to 63. Required."
},
"description": "dkimSelectors, array. Optional."
},
"followPublicUrls": {
"type": "boolean",
"description": "followPublicUrls, boolean. Optional."
},
"authenticationResults": {
"type": "object",
"properties": {
"spf": {
"enum": [
"pass",
"fail",
"softfail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "spf, string, one of pass, fail, softfail, neutral, none, temperror. Optional."
},
"dkim": {
"enum": [
"pass",
"fail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dkim, string, one of pass, fail, neutral, none, temperror, permerror. Optional."
},
"dmarc": {
"enum": [
"pass",
"fail",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dmarc, string, one of pass, fail, none, temperror, permerror, unknown. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
}
},
"description": "authenticationResults, object. Optional."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "id. String."
},
"title": {
"type": "string",
"description": "title. String."
},
"source": {
"type": "string",
"description": "source. String."
},
"status": {
"type": "string",
"description": "status. String."
},
"reasons": {
"type": "array",
"items": {
"type": "string",
"description": "Item. String."
},
"description": "reasons. Array."
},
"detector": {
"type": "string",
"description": "detector. String."
},
"evidence": {
"type": "array",
"items": {
"type": "object",
"properties": {
"fact": {
"type": "string",
"description": "fact. String."
},
"subject": {
"type": "string",
"description": "subject. String."
},
"confidence": {
"type": "string",
"description": "confidence. String."
}
},
"description": "item. Object.",
"additionalProperties": {}
},
"description": "evidence. Array."
},
"confidence": {
"type": "string",
"description": "confidence. String."
},
"relatedIds": {
"type": "array",
"items": {
"type": "string",
"description": "Item. String."
},
"description": "relatedIds. Array."
},
"observedFacts": {
"type": "array",
"items": {
"type": "string",
"description": "Item. String."
},
"description": "observedFacts. Array."
},
"inferredThreat": {
"type": "string",
"description": "inferredThreat. String."
},
"confirmedMalicious": {
"type": "boolean",
"description": "confirmedMalicious. Boolean."
}
},
"description": "item. Object.",
"additionalProperties": {}
},
"description": "items. Array."
},
"chains": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "id. String."
},
"hops": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "url. String."
},
"detail": {
"type": "string",
"description": "detail. String."
},
"status": {
"type": "number",
"description": "status. Number."
},
"blocked": {
"type": "boolean",
"description": "blocked. Boolean."
},
"location": {
"type": "string",
"description": "location. String."
}
},
"description": "item. Object.",
"additionalProperties": {}
},
"description": "hops. Array."
},
"source": {
"type": "string",
"description": "source. String."
},
"hopCount": {
"type": "number",
"description": "hopCount. Number."
},
"startUrl": {
"type": "string",
"description": "startUrl. String."
}
},
"description": "item. Object.",
"additionalProperties": {}
},
"description": "chains. Array."
},
"status": {
"type": "string",
"description": "status. String."
},
"findings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "code. String."
},
"kind": {
"type": "string",
"description": "kind. String."
},
"detail": {
"type": "string",
"description": "detail. String."
},
"subject": {
"type": "string",
"description": "subject. String."
}
},
"description": "item. Object.",
"additionalProperties": {}
},
"description": "findings. Array."
},
"checkedAt": {
"type": "string",
"description": "checkedAt. String."
},
"emailSent": {
"type": "boolean",
"description": "emailSent. Boolean."
},
"chainCount": {
"type": "number",
"description": "chainCount. Number."
},
"limitations": {
"type": "array",
"items": {
"type": "string",
"description": "Item. String."
},
"description": "limitations. Array."
},
"apiKeyRequired": {
"type": "boolean",
"description": "apiKeyRequired. Boolean."
},
"paidProviderUsed": {
"type": "boolean",
"description": "paidProviderUsed. Boolean."
},
"publicDnsQueried": {
"type": "boolean",
"description": "publicDnsQueried. Boolean."
},
"publicUrlsFollowed": {
"type": "boolean",
"description": "publicUrlsFollowed. Boolean."
},
"externalScannerUsed": {
"type": "boolean",
"description": "externalScannerUsed. Boolean."
},
"confirmedMaliciousClaimed": {
"type": "boolean",
"description": "confirmedMaliciousClaimed. Boolean."
},
"attachmentUploadedExternally": {
"type": "boolean",
"description": "attachmentUploadedExternally. Boolean."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Analyze email URL redirect chains",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}| array |
| emails, array. Optional. |
| headers | string | headers, string, length 0 to 200000. Optional. |
| urlHops | array | urlHops, array. Optional. |
| publicDns | boolean | publicDns, boolean. Optional. |
| attachments | array | attachments, array. Optional. |
| brandDomains | array | brandDomains, array. Optional. |
| companyNames | array | companyNames, array. Optional. |
| conversations | array | conversations, array. Optional. |
| dkimSelectors | array | dkimSelectors, array. Optional. |
| followPublicUrls | boolean | followPublicUrls, boolean. Optional. |
| authenticationResults | object | authenticationResults, object. Optional. |
{
"name": "email-security_attachment-risk-analyze",
"title": "Analyze email attachment risk",
"description": "Inspect caller-supplied attachment filenames, metadata, and local magic-byte structures for suspicious patterns before you trust or release an email. No external sandbox or scanner is used. Call with optional text, eml, headers, json, csv, file and others. Returns checkedAt, itemCount, items, paidProviderUsed, apiKeyRequired, externalScannerUsed, emailSent. HTTP 200 with status complete, partial, or failed is charged at the full listed price. HTTP 4xx/5xx are not charged. Keywords: before you trust or release an email, text, eml, headers, csv, file, files, emails, attachments, urls, urlHops, brandDomains, companyNames, conversations, authenticationResults.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"csv": {
"type": "string",
"maxLength": 200000,
"description": "csv, string, length 0 to 200000. Optional."
},
"eml": {
"type": "string",
"maxLength": 500000,
"description": "eml, string, length 0 to 500000. Optional."
},
"asOf": {
"type": "string",
"maxLength": 40,
"description": "asOf, string, length 0 to 40. Optional."
},
"file": {
"type": "object",
"required": [
"fileBase64"
],
"properties": {
"role": {
"type": "string",
"maxLength": 80,
"description": "role, string, length 0 to 80. Optional."
},
"filename": {
"type": "string",
"maxLength": 180,
"minLength": 1,
"description": "filename, string, length 1 to 180. Optional."
},
"mediaType": {
"enum": [
"text/plain",
"message/rfc822",
"text/csv",
"application/json",
"application/octet-stream",
"application/pdf",
"application/zip"
],
"type": "string",
"description": "mediaType, string, one of text/plain, message/rfc822, text/csv, application/json, application/octet-stream, application/pdf. Optional."
},
"fileBase64": {
"type": "string",
"maxLength": 12000000,
"minLength": 1,
"description": "fileBase64, string, length 1 to 12000000. Required."
}
},
"description": "file, object. Optional."
},
"json": {
"type": "string",
"maxLength": 200000,
"description": "json, string, length 0 to 200000. Optional."
},
"text": {
"type": "string",
"maxLength": 500000,
"description": "text, string, length 0 to 500000. Optional."
},
"urls": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000,
"description": "item, string, length 0 to 2000. Required."
},
"description": "urls, array. Optional."
},
"files": {
"type": "array",
"items": {
"type": "object",
"required": [
"fileBase64"
],
"properties": {
"role": {
"type": "string",
"maxLength": 80,
"description": "role, string, length 0 to 80. Optional."
},
"filename": {
"type": "string",
"maxLength": 180,
"minLength": 1,
"description": "filename, string, length 1 to 180. Optional."
},
"mediaType": {
"enum": [
"text/plain",
"message/rfc822",
"text/csv",
"application/json",
"application/octet-stream",
"application/pdf",
"application/zip"
],
"type": "string",
"description": "mediaType, string, one of text/plain, message/rfc822, text/csv, application/json, application/octet-stream, application/pdf. Optional."
},
"fileBase64": {
"type": "string",
"maxLength": 12000000,
"minLength": 1,
"description": "fileBase64, string, length 1 to 12000000. Required."
}
},
"description": "item, object. Required."
},
"description": "files, array. Optional."
},
"emails": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cc": {
"type": "string",
"maxLength": 2000,
"description": "cc, string, length 0 to 2000. Optional."
},
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"to": {
"type": "string",
"maxLength": 2000,
"description": "to, string, length 0 to 2000. Optional."
},
"raw": {
"type": "string",
"maxLength": 500000,
"description": "raw, string, length 0 to 500000. Optional."
},
"date": {
"type": "string",
"maxLength": 80,
"description": "date, string, length 0 to 80. Optional."
},
"from": {
"type": "string",
"maxLength": 500,
"description": "from, string, length 0 to 500. Optional."
},
"urls": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000,
"description": "item, string, length 0 to 2000. Required."
},
"description": "urls, array. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"headers": {
"type": "string",
"maxLength": 200000,
"description": "headers, string, length 0 to 200000. Optional."
},
"replyTo": {
"type": "string",
"maxLength": 500,
"description": "replyTo, string, length 0 to 500. Optional."
},
"subject": {
"type": "string",
"maxLength": 998,
"description": "subject, string, length 0 to 998. Optional."
},
"bodyHtml": {
"type": "string",
"maxLength": 200000,
"description": "bodyHtml, string, length 0 to 200000. Optional."
},
"bodyText": {
"type": "string",
"maxLength": 200000,
"description": "bodyText, string, length 0 to 200000. Optional."
},
"inReplyTo": {
"type": "string",
"maxLength": 300,
"description": "inReplyTo, string, length 0 to 300. Optional."
},
"messageId": {
"type": "string",
"maxLength": 300,
"description": "messageId, string, length 0 to 300. Optional."
},
"references": {
"type": "string",
"maxLength": 4000,
"description": "references, string, length 0 to 4000. Optional."
},
"returnPath": {
"type": "string",
"maxLength": 500,
"description": "returnPath, string, length 0 to 500. Optional."
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"sha256": {
"type": "string",
"maxLength": 128,
"description": "sha256, string, length 0 to 128. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"filename": {
"type": "string",
"maxLength": 260,
"description": "filename, string, length 0 to 260. Optional."
},
"mediaType": {
"type": "string",
"maxLength": 120,
"description": "mediaType, string, length 0 to 120. Optional."
},
"sizeBytes": {
"type": "number",
"maximum": 100000000,
"minimum": 0,
"description": "sizeBytes, number, from 0 to 100000000. Optional."
},
"contentBase64": {
"type": "string",
"maxLength": 12000000,
"description": "contentBase64, string, length 0 to 12000000. Optional."
}
},
"description": "item, object. Required."
},
"description": "attachments, array. Optional."
},
"authenticationResults": {
"type": "object",
"properties": {
"spf": {
"enum": [
"pass",
"fail",
"softfail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "spf, string, one of pass, fail, softfail, neutral, none, temperror. Optional."
},
"dkim": {
"enum": [
"pass",
"fail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dkim, string, one of pass, fail, neutral, none, temperror, permerror. Optional."
},
"dmarc": {
"enum": [
"pass",
"fail",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dmarc, string, one of pass, fail, none, temperror, permerror, unknown. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
}
},
"description": "authenticationResults, object. Optional."
}
},
"description": "item, object. Required."
},
"description": "emails, array. Optional."
},
"headers": {
"type": "string",
"maxLength": 200000,
"description": "headers, string, length 0 to 200000. Optional."
},
"urlHops": {
"type": "array",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "url, string, length 1 to 2000. Required."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"status": {
"type": "number",
"maximum": 999,
"minimum": 0,
"description": "status, number, from 0 to 999. Optional."
},
"location": {
"type": "string",
"maxLength": 2000,
"description": "location, string, length 0 to 2000. Optional."
}
},
"description": "item, object. Required."
},
"description": "urlHops, array. Optional."
},
"publicDns": {
"type": "boolean",
"description": "publicDns, boolean. Optional."
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"sha256": {
"type": "string",
"maxLength": 128,
"description": "sha256, string, length 0 to 128. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"filename": {
"type": "string",
"maxLength": 260,
"description": "filename, string, length 0 to 260. Optional."
},
"mediaType": {
"type": "string",
"maxLength": 120,
"description": "mediaType, string, length 0 to 120. Optional."
},
"sizeBytes": {
"type": "number",
"maximum": 100000000,
"minimum": 0,
"description": "sizeBytes, number, from 0 to 100000000. Optional."
},
"contentBase64": {
"type": "string",
"maxLength": 12000000,
"description": "contentBase64, string, length 0 to 12000000. Optional."
}
},
"description": "item, object. Required."
},
"description": "attachments, array. Optional."
},
"brandDomains": {
"type": "array",
"items": {
"type": "string",
"maxLength": 253,
"description": "item, string, length 0 to 253. Required."
},
"description": "brandDomains, array. Optional."
},
"companyNames": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"description": "item, string, length 0 to 200. Required."
},
"description": "companyNames, array. Optional."
},
"conversations": {
"type": "array",
"items": {
"type": "object",
"required": [
"emails"
],
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"label": {
"type": "string",
"maxLength": 120,
"description": "label, string, length 0 to 120. Optional."
},
"emails": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cc": {
"type": "string",
"maxLength": 2000,
"description": "cc, string, length 0 to 2000. Optional."
},
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"to": {
"type": "string",
"maxLength": 2000,
"description": "to, string, length 0 to 2000. Optional."
},
"raw": {
"type": "string",
"maxLength": 500000,
"description": "raw, string, length 0 to 500000. Optional."
},
"date": {
"type": "string",
"maxLength": 80,
"description": "date, string, length 0 to 80. Optional."
},
"from": {
"type": "string",
"maxLength": 500,
"description": "from, string, length 0 to 500. Optional."
},
"urls": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000,
"description": "item, string, length 0 to 2000. Required."
},
"description": "urls, array. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"headers": {
"type": "string",
"maxLength": 200000,
"description": "headers, string, length 0 to 200000. Optional."
},
"replyTo": {
"type": "string",
"maxLength": 500,
"description": "replyTo, string, length 0 to 500. Optional."
},
"subject": {
"type": "string",
"maxLength": 998,
"description": "subject, string, length 0 to 998. Optional."
},
"bodyHtml": {
"type": "string",
"maxLength": 200000,
"description": "bodyHtml, string, length 0 to 200000. Optional."
},
"bodyText": {
"type": "string",
"maxLength": 200000,
"description": "bodyText, string, length 0 to 200000. Optional."
},
"inReplyTo": {
"type": "string",
"maxLength": 300,
"description": "inReplyTo, string, length 0 to 300. Optional."
},
"messageId": {
"type": "string",
"maxLength": 300,
"description": "messageId, string, length 0 to 300. Optional."
},
"references": {
"type": "string",
"maxLength": 4000,
"description": "references, string, length 0 to 4000. Optional."
},
"returnPath": {
"type": "string",
"maxLength": 500,
"description": "returnPath, string, length 0 to 500. Optional."
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"sha256": {
"type": "string",
"maxLength": 128,
"description": "sha256, string, length 0 to 128. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"filename": {
"type": "string",
"maxLength": 260,
"description": "filename, string, length 0 to 260. Optional."
},
"mediaType": {
"type": "string",
"maxLength": 120,
"description": "mediaType, string, length 0 to 120. Optional."
},
"sizeBytes": {
"type": "number",
"maximum": 100000000,
"minimum": 0,
"description": "sizeBytes, number, from 0 to 100000000. Optional."
},
"contentBase64": {
"type": "string",
"maxLength": 12000000,
"description": "contentBase64, string, length 0 to 12000000. Optional."
}
},
"description": "item, object. Required."
},
"description": "attachments, array. Optional."
},
"authenticationResults": {
"type": "object",
"properties": {
"spf": {
"enum": [
"pass",
"fail",
"softfail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "spf, string, one of pass, fail, softfail, neutral, none, temperror. Optional."
},
"dkim": {
"enum": [
"pass",
"fail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dkim, string, one of pass, fail, neutral, none, temperror, permerror. Optional."
},
"dmarc": {
"enum": [
"pass",
"fail",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dmarc, string, one of pass, fail, none, temperror, permerror, unknown. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
}
},
"description": "authenticationResults, object. Optional."
}
},
"description": "item, object. Required."
},
"description": "emails, array. Required."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
}
},
"description": "item, object. Required."
},
"description": "conversations, array. Optional."
},
"dkimSelectors": {
"type": "array",
"items": {
"type": "string",
"maxLength": 63,
"minLength": 1,
"description": "item, string, length 1 to 63. Required."
},
"description": "dkimSelectors, array. Optional."
},
"followPublicUrls": {
"type": "boolean",
"description": "followPublicUrls, boolean. Optional."
},
"authenticationResults": {
"type": "object",
"properties": {
"spf": {
"enum": [
"pass",
"fail",
"softfail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "spf, string, one of pass, fail, softfail, neutral, none, temperror. Optional."
},
"dkim": {
"enum": [
"pass",
"fail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dkim, string, one of pass, fail, neutral, none, temperror, permerror. Optional."
},
"dmarc": {
"enum": [
"pass",
"fail",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dmarc, string, one of pass, fail, none, temperror, permerror, unknown. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
}
},
"description": "authenticationResults, object. Optional."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "id. String."
},
"title": {
"type": "string",
"description": "title. String."
},
"source": {
"type": "string",
"description": "source. String."
},
"status": {
"type": "string",
"description": "status. String."
},
"reasons": {
"type": "array",
"items": {
"type": "string",
"description": "Item. String."
},
"description": "reasons. Array."
},
"detector": {
"type": "string",
"description": "detector. String."
},
"evidence": {
"type": "array",
"items": {
"type": "object",
"properties": {
"fact": {
"type": "string",
"description": "fact. String."
},
"subject": {
"type": "string",
"description": "subject. String."
},
"inference": {
"type": "string",
"description": "inference. String."
},
"confidence": {
"type": "string",
"description": "confidence. String."
}
},
"description": "item. Object.",
"additionalProperties": {}
},
"description": "evidence. Array."
},
"confidence": {
"type": "string",
"description": "confidence. String."
},
"relatedIds": {
"type": "array",
"items": {
"type": "string",
"description": "Item. String."
},
"description": "relatedIds. Array."
},
"observedFacts": {
"type": "array",
"items": {
"type": "string",
"description": "Item. String."
},
"description": "observedFacts. Array."
},
"inferredThreat": {
"type": "string",
"description": "inferredThreat. String."
},
"confirmedMalicious": {
"type": "boolean",
"description": "confirmedMalicious. Boolean."
}
},
"description": "item. Object.",
"additionalProperties": {}
},
"description": "items. Array."
},
"status": {
"type": "string",
"description": "status. String."
},
"findings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "code. String."
},
"kind": {
"type": "string",
"description": "kind. String."
},
"detail": {
"type": "string",
"description": "detail. String."
},
"subject": {
"type": "string",
"description": "subject. String."
}
},
"description": "item. Object.",
"additionalProperties": {}
},
"description": "findings. Array."
},
"checkedAt": {
"type": "string",
"description": "checkedAt. String."
},
"emailSent": {
"type": "boolean",
"description": "emailSent. Boolean."
},
"itemCount": {
"type": "number",
"description": "itemCount. Number."
},
"limitations": {
"type": "array",
"items": {
"type": "string",
"description": "Item. String."
},
"description": "limitations. Array."
},
"apiKeyRequired": {
"type": "boolean",
"description": "apiKeyRequired. Boolean."
},
"paidProviderUsed": {
"type": "boolean",
"description": "paidProviderUsed. Boolean."
},
"publicDnsQueried": {
"type": "boolean",
"description": "publicDnsQueried. Boolean."
},
"publicUrlsFollowed": {
"type": "boolean",
"description": "publicUrlsFollowed. Boolean."
},
"externalScannerUsed": {
"type": "boolean",
"description": "externalScannerUsed. Boolean."
},
"confirmedMaliciousClaimed": {
"type": "boolean",
"description": "confirmedMaliciousClaimed. Boolean."
},
"attachmentUploadedExternally": {
"type": "boolean",
"description": "attachmentUploadedExternally. Boolean."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Analyze email attachment risk",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}| emails, array. Optional. |
| headers | string | headers, string, length 0 to 200000. Optional. |
| urlHops | array | urlHops, array. Optional. |
| publicDns | boolean | publicDns, boolean. Optional. |
| attachments | array | attachments, array. Optional. |
| brandDomains | array | brandDomains, array. Optional. |
| companyNames | array | companyNames, array. Optional. |
| conversations | array | conversations, array. Optional. |
| dkimSelectors | array | dkimSelectors, array. Optional. |
| followPublicUrls | boolean | followPublicUrls, boolean. Optional. |
| authenticationResults | object | authenticationResults, object. Optional. |
{
"name": "email-security_conversation-tamper-detect",
"title": "Detect conversation tampering",
"description": "Identify inconsistencies between supplied email conversation copies (missing messages, body hash mismatches, header field divergence) before you trust or release an email. Export artifacts are distinguished from confirmed tampering. Call with optional text, eml, headers, json, csv, file and others. HTTP 200 with status complete, partial, or failed is charged at the full listed price. HTTP 4xx/5xx are not charged. Keywords: before you trust or release an email, text, eml, headers, csv, file, files, emails, attachments, urls, urlHops, brandDomains, companyNames, conversations, authenticationResults.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"csv": {
"type": "string",
"maxLength": 200000,
"description": "csv, string, length 0 to 200000. Optional."
},
"eml": {
"type": "string",
"maxLength": 500000,
"description": "eml, string, length 0 to 500000. Optional."
},
"asOf": {
"type": "string",
"maxLength": 40,
"description": "asOf, string, length 0 to 40. Optional."
},
"file": {
"type": "object",
"required": [
"fileBase64"
],
"properties": {
"role": {
"type": "string",
"maxLength": 80,
"description": "role, string, length 0 to 80. Optional."
},
"filename": {
"type": "string",
"maxLength": 180,
"minLength": 1,
"description": "filename, string, length 1 to 180. Optional."
},
"mediaType": {
"enum": [
"text/plain",
"message/rfc822",
"text/csv",
"application/json",
"application/octet-stream",
"application/pdf",
"application/zip"
],
"type": "string",
"description": "mediaType, string, one of text/plain, message/rfc822, text/csv, application/json, application/octet-stream, application/pdf. Optional."
},
"fileBase64": {
"type": "string",
"maxLength": 12000000,
"minLength": 1,
"description": "fileBase64, string, length 1 to 12000000. Required."
}
},
"description": "file, object. Optional."
},
"json": {
"type": "string",
"maxLength": 200000,
"description": "json, string, length 0 to 200000. Optional."
},
"text": {
"type": "string",
"maxLength": 500000,
"description": "text, string, length 0 to 500000. Optional."
},
"urls": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000,
"description": "item, string, length 0 to 2000. Required."
},
"description": "urls, array. Optional."
},
"files": {
"type": "array",
"items": {
"type": "object",
"required": [
"fileBase64"
],
"properties": {
"role": {
"type": "string",
"maxLength": 80,
"description": "role, string, length 0 to 80. Optional."
},
"filename": {
"type": "string",
"maxLength": 180,
"minLength": 1,
"description": "filename, string, length 1 to 180. Optional."
},
"mediaType": {
"enum": [
"text/plain",
"message/rfc822",
"text/csv",
"application/json",
"application/octet-stream",
"application/pdf",
"application/zip"
],
"type": "string",
"description": "mediaType, string, one of text/plain, message/rfc822, text/csv, application/json, application/octet-stream, application/pdf. Optional."
},
"fileBase64": {
"type": "string",
"maxLength": 12000000,
"minLength": 1,
"description": "fileBase64, string, length 1 to 12000000. Required."
}
},
"description": "item, object. Required."
},
"description": "files, array. Optional."
},
"emails": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cc": {
"type": "string",
"maxLength": 2000,
"description": "cc, string, length 0 to 2000. Optional."
},
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"to": {
"type": "string",
"maxLength": 2000,
"description": "to, string, length 0 to 2000. Optional."
},
"raw": {
"type": "string",
"maxLength": 500000,
"description": "raw, string, length 0 to 500000. Optional."
},
"date": {
"type": "string",
"maxLength": 80,
"description": "date, string, length 0 to 80. Optional."
},
"from": {
"type": "string",
"maxLength": 500,
"description": "from, string, length 0 to 500. Optional."
},
"urls": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000,
"description": "item, string, length 0 to 2000. Required."
},
"description": "urls, array. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"headers": {
"type": "string",
"maxLength": 200000,
"description": "headers, string, length 0 to 200000. Optional."
},
"replyTo": {
"type": "string",
"maxLength": 500,
"description": "replyTo, string, length 0 to 500. Optional."
},
"subject": {
"type": "string",
"maxLength": 998,
"description": "subject, string, length 0 to 998. Optional."
},
"bodyHtml": {
"type": "string",
"maxLength": 200000,
"description": "bodyHtml, string, length 0 to 200000. Optional."
},
"bodyText": {
"type": "string",
"maxLength": 200000,
"description": "bodyText, string, length 0 to 200000. Optional."
},
"inReplyTo": {
"type": "string",
"maxLength": 300,
"description": "inReplyTo, string, length 0 to 300. Optional."
},
"messageId": {
"type": "string",
"maxLength": 300,
"description": "messageId, string, length 0 to 300. Optional."
},
"references": {
"type": "string",
"maxLength": 4000,
"description": "references, string, length 0 to 4000. Optional."
},
"returnPath": {
"type": "string",
"maxLength": 500,
"description": "returnPath, string, length 0 to 500. Optional."
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"sha256": {
"type": "string",
"maxLength": 128,
"description": "sha256, string, length 0 to 128. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"filename": {
"type": "string",
"maxLength": 260,
"description": "filename, string, length 0 to 260. Optional."
},
"mediaType": {
"type": "string",
"maxLength": 120,
"description": "mediaType, string, length 0 to 120. Optional."
},
"sizeBytes": {
"type": "number",
"maximum": 100000000,
"minimum": 0,
"description": "sizeBytes, number, from 0 to 100000000. Optional."
},
"contentBase64": {
"type": "string",
"maxLength": 12000000,
"description": "contentBase64, string, length 0 to 12000000. Optional."
}
},
"description": "item, object. Required."
},
"description": "attachments, array. Optional."
},
"authenticationResults": {
"type": "object",
"properties": {
"spf": {
"enum": [
"pass",
"fail",
"softfail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "spf, string, one of pass, fail, softfail, neutral, none, temperror. Optional."
},
"dkim": {
"enum": [
"pass",
"fail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dkim, string, one of pass, fail, neutral, none, temperror, permerror. Optional."
},
"dmarc": {
"enum": [
"pass",
"fail",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dmarc, string, one of pass, fail, none, temperror, permerror, unknown. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
}
},
"description": "authenticationResults, object. Optional."
}
},
"description": "item, object. Required."
},
"description": "emails, array. Optional."
},
"headers": {
"type": "string",
"maxLength": 200000,
"description": "headers, string, length 0 to 200000. Optional."
},
"urlHops": {
"type": "array",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "url, string, length 1 to 2000. Required."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"status": {
"type": "number",
"maximum": 999,
"minimum": 0,
"description": "status, number, from 0 to 999. Optional."
},
"location": {
"type": "string",
"maxLength": 2000,
"description": "location, string, length 0 to 2000. Optional."
}
},
"description": "item, object. Required."
},
"description": "urlHops, array. Optional."
},
"publicDns": {
"type": "boolean",
"description": "publicDns, boolean. Optional."
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"sha256": {
"type": "string",
"maxLength": 128,
"description": "sha256, string, length 0 to 128. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"filename": {
"type": "string",
"maxLength": 260,
"description": "filename, string, length 0 to 260. Optional."
},
"mediaType": {
"type": "string",
"maxLength": 120,
"description": "mediaType, string, length 0 to 120. Optional."
},
"sizeBytes": {
"type": "number",
"maximum": 100000000,
"minimum": 0,
"description": "sizeBytes, number, from 0 to 100000000. Optional."
},
"contentBase64": {
"type": "string",
"maxLength": 12000000,
"description": "contentBase64, string, length 0 to 12000000. Optional."
}
},
"description": "item, object. Required."
},
"description": "attachments, array. Optional."
},
"brandDomains": {
"type": "array",
"items": {
"type": "string",
"maxLength": 253,
"description": "item, string, length 0 to 253. Required."
},
"description": "brandDomains, array. Optional."
},
"companyNames": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"description": "item, string, length 0 to 200. Required."
},
"description": "companyNames, array. Optional."
},
"conversations": {
"type": "array",
"items": {
"type": "object",
"required": [
"emails"
],
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"label": {
"type": "string",
"maxLength": 120,
"description": "label, string, length 0 to 120. Optional."
},
"emails": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cc": {
"type": "string",
"maxLength": 2000,
"description": "cc, string, length 0 to 2000. Optional."
},
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"to": {
"type": "string",
"maxLength": 2000,
"description": "to, string, length 0 to 2000. Optional."
},
"raw": {
"type": "string",
"maxLength": 500000,
"description": "raw, string, length 0 to 500000. Optional."
},
"date": {
"type": "string",
"maxLength": 80,
"description": "date, string, length 0 to 80. Optional."
},
"from": {
"type": "string",
"maxLength": 500,
"description": "from, string, length 0 to 500. Optional."
},
"urls": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000,
"description": "item, string, length 0 to 2000. Required."
},
"description": "urls, array. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"headers": {
"type": "string",
"maxLength": 200000,
"description": "headers, string, length 0 to 200000. Optional."
},
"replyTo": {
"type": "string",
"maxLength": 500,
"description": "replyTo, string, length 0 to 500. Optional."
},
"subject": {
"type": "string",
"maxLength": 998,
"description": "subject, string, length 0 to 998. Optional."
},
"bodyHtml": {
"type": "string",
"maxLength": 200000,
"description": "bodyHtml, string, length 0 to 200000. Optional."
},
"bodyText": {
"type": "string",
"maxLength": 200000,
"description": "bodyText, string, length 0 to 200000. Optional."
},
"inReplyTo": {
"type": "string",
"maxLength": 300,
"description": "inReplyTo, string, length 0 to 300. Optional."
},
"messageId": {
"type": "string",
"maxLength": 300,
"description": "messageId, string, length 0 to 300. Optional."
},
"references": {
"type": "string",
"maxLength": 4000,
"description": "references, string, length 0 to 4000. Optional."
},
"returnPath": {
"type": "string",
"maxLength": 500,
"description": "returnPath, string, length 0 to 500. Optional."
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "id, string, length 0 to 80. Optional."
},
"sha256": {
"type": "string",
"maxLength": 128,
"description": "sha256, string, length 0 to 128. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
},
"filename": {
"type": "string",
"maxLength": 260,
"description": "filename, string, length 0 to 260. Optional."
},
"mediaType": {
"type": "string",
"maxLength": 120,
"description": "mediaType, string, length 0 to 120. Optional."
},
"sizeBytes": {
"type": "number",
"maximum": 100000000,
"minimum": 0,
"description": "sizeBytes, number, from 0 to 100000000. Optional."
},
"contentBase64": {
"type": "string",
"maxLength": 12000000,
"description": "contentBase64, string, length 0 to 12000000. Optional."
}
},
"description": "item, object. Required."
},
"description": "attachments, array. Optional."
},
"authenticationResults": {
"type": "object",
"properties": {
"spf": {
"enum": [
"pass",
"fail",
"softfail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "spf, string, one of pass, fail, softfail, neutral, none, temperror. Optional."
},
"dkim": {
"enum": [
"pass",
"fail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dkim, string, one of pass, fail, neutral, none, temperror, permerror. Optional."
},
"dmarc": {
"enum": [
"pass",
"fail",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dmarc, string, one of pass, fail, none, temperror, permerror, unknown. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
}
},
"description": "authenticationResults, object. Optional."
}
},
"description": "item, object. Required."
},
"description": "emails, array. Required."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
}
},
"description": "item, object. Required."
},
"description": "conversations, array. Optional."
},
"dkimSelectors": {
"type": "array",
"items": {
"type": "string",
"maxLength": 63,
"minLength": 1,
"description": "item, string, length 1 to 63. Required."
},
"description": "dkimSelectors, array. Optional."
},
"followPublicUrls": {
"type": "boolean",
"description": "followPublicUrls, boolean. Optional."
},
"authenticationResults": {
"type": "object",
"properties": {
"spf": {
"enum": [
"pass",
"fail",
"softfail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "spf, string, one of pass, fail, softfail, neutral, none, temperror. Optional."
},
"dkim": {
"enum": [
"pass",
"fail",
"neutral",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dkim, string, one of pass, fail, neutral, none, temperror, permerror. Optional."
},
"dmarc": {
"enum": [
"pass",
"fail",
"none",
"temperror",
"permerror",
"unknown"
],
"type": "string",
"description": "dmarc, string, one of pass, fail, none, temperror, permerror, unknown. Optional."
},
"source": {
"type": "string",
"maxLength": 200,
"description": "source, string, length 0 to 200. Optional."
}
},
"description": "authenticationResults, object. Optional."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "id. String."
},
"title": {
"type": "string",
"description": "title. String."
},
"source": {
"type": "string",
"description": "source. String."
},
"status": {
"type": "string",
"description": "status. String."
},
"reasons": {
"type": "array",
"items": {
"type": "string",
"description": "Item. String."
},
"description": "reasons. Array."
},
"detector": {
"type": "string",
"description": "detector. String."
},
"evidence": {
"type": "array",
"items": {
"type": "object",
"properties": {
"fact": {
"type": "string",
"description": "fact. String."
},
"subject": {
"type": "string",
"description": "subject. String."
},
"inference": {
"type": "string",
"description": "inference. String."
},
"confidence": {
"type": "string",
"description": "confidence. String."
}
},
"description": "item. Object.",
"additionalProperties": {}
},
"description": "evidence. Array."
},
"confidence": {
"type": "string",
"description": "confidence. String."
},
"relatedIds": {
"type": "array",
"items": {
"type": "string",
"description": "Item. String."
},
"description": "relatedIds. Array."
},
"observedFacts": {
"type": "array",
"items": {
"type": "string",
"description": "Item. String."
},
"description": "observedFacts. Array."
},
"inferredThreat": {
"type": "string",
"description": "inferredThreat. String."
},
"confirmedMalicious": {
"type": "boolean",
"description": "confirmedMalicious. Boolean."
}
},
"description": "item. Object.",
"additionalProperties": {}
},
"description": "items. Array."
},
"status": {
"type": "string",
"description": "status. String."
},
"findings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "code. String."
},
"kind": {
"type": "string",
"description": "kind. String."
},
"detail": {
"type": "string",
"description": "detail. String."
},
"subject": {
"type": "string",
"description": "subject. String."
}
},
"description": "item. Object.",
"additionalProperties": {}
},
"description": "findings. Array."
},
"checkedAt": {
"type": "string",
"description": "checkedAt. String."
},
"emailSent": {
"type": "boolean",
"description": "emailSent. Boolean."
},
"itemCount": {
"type": "number",
"description": "itemCount. Number."
},
"limitations": {
"type": "array",
"items": {
"type": "string",
"description": "Item. String."
},
"description": "limitations. Array."
},
"apiKeyRequired": {
"type": "boolean",
"description": "apiKeyRequired. Boolean."
},
"comparedCopies": {
"type": "array",
"items": {
"type": "string",
"description": "Item. String."
},
"description": "comparedCopies. Array."
},
"paidProviderUsed": {
"type": "boolean",
"description": "paidProviderUsed. Boolean."
},
"publicDnsQueried": {
"type": "boolean",
"description": "publicDnsQueried. Boolean."
},
"publicUrlsFollowed": {
"type": "boolean",
"description": "publicUrlsFollowed. Boolean."
},
"externalScannerUsed": {
"type": "boolean",
"description": "externalScannerUsed. Boolean."
},
"confirmedMaliciousClaimed": {
"type": "boolean",
"description": "confirmedMaliciousClaimed. Boolean."
},
"attachmentUploadedExternally": {
"type": "boolean",
"description": "attachmentUploadedExternally. Boolean."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Detect conversation tampering",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}