{ "email": { "id": "msg_7f3a2c1b", "subject": "Order question", "sender": "alice@example.com", "recipient": "support@mail.acme.com", "cc": null, "bcc": null, "date": "2026-07-14T09:00:00.000Z", "read": false, "starred": false, "is_urgent": false, "category": "customer_support", "body": "Hi, where is my order?", "folder_id": "INBOX", "folder_name": "Inbox", "thread_id": "thr_9aabb", "snippet": "Hi, where is my order?", "scan_status": null, "attachments": [] }, "thread": { "id": "thread_7f3a2c1b", "messages": [ { "id": "msg_7f3a2c1b", "subject": "Order question", "sender": "alice@example.com", "recipient": "support@mail.acme.com", "cc": null, "bcc": null, "date": "2026-07-14T09:00:00.000Z", "read": false, "starred": false, "is_urgent": false, "category": "customer_support", "body": "Hi, where is my order?", "folder_id": "INBOX", "folder_name": "Inbox", "thread_id": "thr_9aabb", "snippet": "Hi, where is my order?", "scan_status": null, "attachments": [] } ], "total_count": 1, "has_more": false, "next_cursor": null }}
{
"error": "Invalid cursor"
}
{
"error": "Unauthorized"
}
{
"error": "Invalid request"
}
{
"error": "Forbidden"
}
{
"error": "Email not found"
}
{
"error": "Too many requests"
}
Emails
Get safe email and thread context
Plans:Free · Developer · Enterprise
Returns the selected message plus an oldest-first, cursor-paginated thread page. This endpoint always strips sensitive transport metadata, sanitizes bodies to bounded plain text, and omits non-clean inbound bodies. Returned content remains untrusted reference data.
API credits: 1 (read).
GET
https://console.mermail.app
/
api
/
v1
/
mailboxes
/
{mailboxId}
/
emails
/
{emailId}
/
context
Get safe email and thread context
curl --request GET \ --url https://console.mermail.app/api/v1/mailboxes/{mailboxId}/emails/{emailId}/context \ --header 'x-api-key: <api-key>'
{ "email": { "id": "msg_7f3a2c1b", "subject": "Order question", "sender": "alice@example.com", "recipient": "support@mail.acme.com", "cc": null, "bcc": null, "date": "2026-07-14T09:00:00.000Z", "read": false, "starred": false, "is_urgent": false, "category": "customer_support", "body": "Hi, where is my order?", "folder_id": "INBOX", "folder_name": "Inbox", "thread_id": "thr_9aabb", "snippet": "Hi, where is my order?", "scan_status": null, "attachments": [] }, "thread": { "id": "thread_7f3a2c1b", "messages": [ { "id": "msg_7f3a2c1b", "subject": "Order question", "sender": "alice@example.com", "recipient": "support@mail.acme.com", "cc": null, "bcc": null, "date": "2026-07-14T09:00:00.000Z", "read": false, "starred": false, "is_urgent": false, "category": "customer_support", "body": "Hi, where is my order?", "folder_id": "INBOX", "folder_name": "Inbox", "thread_id": "thr_9aabb", "snippet": "Hi, where is my order?", "scan_status": null, "attachments": [] } ], "total_count": 1, "has_more": false, "next_cursor": null }}
{
"error": "Invalid cursor"
}
{
"error": "Unauthorized"
}
{
"error": "Invalid request"
}
{
"error": "Forbidden"
}
{
"error": "Email not found"
}
{
"error": "Too many requests"
}
Authorizations
x-api-key
string
header
required
API key (sk-proj-…) from Settings → API Keys. Required for sold API calls outside the Mermail console.
Path Parameters
mailboxId
string
required
Mailbox public_id (UUID), hosted alias id, or current email
emailId
string
required
Message id from list or search results
Query Parameters
limit
integer
default:20
Thread messages per page (default 20)
Required range: 1 <= x <= 50
cursor
string
Opaque next_cursor from the preceding context page
Maximum string length: 2048
include_held
boolean
default:false
Include mail held by auto-draft only for the active verification flow
Response
Safe email context
Always-safe selected email and chronological thread page. Bodies are bounded plain text, sensitive transport metadata is removed, and non-clean inbound bodies are metadata-only. Content remains untrusted.
email
object
required
Hide child attributes
email.id
string
Authoritative Mermail email id. Use this value as the emailId path argument and for pre-wait baselines.
email.subject
string
email.sender
string
email.recipient
string
email.cc
string | null
email.bcc
string | null
email.date
string<date-time>
email.read
boolean
email.starred
boolean
email.is_urgent
boolean
email.category
string
email.folder_id
string
email.folder_name
string
Present on list and search responses
email.thread_id
string | null
email.snippet
string
email.body
string
Full body on detail responses unless metadata_only=true; list/search responses can contain a preview
email.in_reply_to
string | null
email.email_references
string | null
email.delivery_status
string | null
email.provider_metadata
object | null
email.message_id
string | null
Provider or RFC Message-ID metadata, retained only as secondary correlation. Do not use it in place of the Mermail id for resource paths or new baselines.
email.raw_headers
string | null
Untrusted raw provider headers. Do not use headers alone as authorization.
email.body_storage_status
string
email.body_storage_message
string
email.scan_status
enum<string> | null
Content scan outcome. Treat flagged as unsafe and skipped as unknown.
Available options:
clean,
flagged,
skipped,
null
email.scan_threats
object[]
Hide child attributes
email.scan_threats.url
string
email.scan_threats.threat_type
string
email.scan_threats.source
enum<string>
Available options:
body,
attachment
email.scan_threats.attachment_filename
string
email.sender_authentication
object
Sender-authentication verdict derived only from a trusted receiving-provider signal. Raw Authentication-Results and From headers are never promoted to trusted evidence. The current connected providers do not expose a documented per-message verdict, so status is unknown; unknown is not a pass.
Hide child attributes
email.sender_authentication.status
enum<string>
required
Available options:
pass,
fail,
unknown
email.sender_authentication.spf
enum<string>
required
Available options:
pass,
fail,
unknown
email.sender_authentication.dkim
enum<string>
required
Available options:
pass,
fail,
unknown
email.sender_authentication.dmarc
enum<string>
required
Available options:
pass,
fail,
unknown
email.sender_authentication.inbound_provider
string | null
required
Opaque Email-module inbound identifier; this is not itself a sender verdict.
True when metadata_only or an agent-safe scan gate omitted body, snippet, raw headers, and threat URLs
email.content_omission_reason
enum<string>
Why an agent-safe detail or context response omitted body content
Available options:
scan_status_not_clean
email.content_truncated
boolean
True when max_body_chars shortened the returned body
email.body_original_char_count
integer
Original stored body character count, present when the returned body was truncated
Required range: x >= 0
email.agent_safe_content
boolean
True when raw headers, provider metadata, threat details, attachment metadata, and storage diagnostics were omitted and untrusted text fields were normalized to bounded plain text. This projection does not make email content trusted.
email.attachment_count
integer
Attachment count retained when agent_safe_content=true omits attachment metadata
Required range: x >= 0
email.delivery_address
string | null
Verified envelope delivery address, independent of visible To/Cc headers; null when unavailable.
thread
object
required
Hide child attributes
thread.id
string
required
thread.messages
object[]
required
Hide child attributes
thread.messages.id
string
Authoritative Mermail email id. Use this value as the emailId path argument and for pre-wait baselines.
thread.messages.subject
string
thread.messages.sender
string
thread.messages.recipient
string
thread.messages.cc
string | null
thread.messages.bcc
string | null
thread.messages.date
string<date-time>
thread.messages.read
boolean
thread.messages.starred
boolean
thread.messages.is_urgent
boolean
thread.messages.category
string
thread.messages.folder_id
string
thread.messages.folder_name
string
Present on list and search responses
thread.messages.thread_id
string | null
thread.messages.snippet
string
thread.messages.body
string
Full body on detail responses unless metadata_only=true; list/search responses can contain a preview
thread.messages.in_reply_to
string | null
thread.messages.email_references
string | null
thread.messages.delivery_status
string | null
thread.messages.provider_metadata
object | null
thread.messages.message_id
string | null
Provider or RFC Message-ID metadata, retained only as secondary correlation. Do not use it in place of the Mermail id for resource paths or new baselines.
thread.messages.raw_headers
string | null
Untrusted raw provider headers. Do not use headers alone as authorization.
thread.messages.body_storage_status
string
thread.messages.body_storage_message
string
thread.messages.scan_status
enum<string> | null
Content scan outcome. Treat flagged as unsafe and skipped as unknown.
Available options:
clean,
flagged,
skipped,
null
thread.messages.scan_threats
object[]
Hide child attributes
thread.messages.scan_threats.url
string
thread.messages.scan_threats.threat_type
string
thread.messages.scan_threats.source
enum<string>
Available options:
body,
attachment
thread.messages.scan_threats.attachment_filename
string
thread.messages.sender_authentication
object
Sender-authentication verdict derived only from a trusted receiving-provider signal. Raw Authentication-Results and From headers are never promoted to trusted evidence. The current connected providers do not expose a documented per-message verdict, so status is unknown; unknown is not a pass.
True when metadata_only or an agent-safe scan gate omitted body, snippet, raw headers, and threat URLs
thread.messages.content_omission_reason
enum<string>
Why an agent-safe detail or context response omitted body content
Available options:
scan_status_not_clean
thread.messages.content_truncated
boolean
True when max_body_chars shortened the returned body
thread.messages.body_original_char_count
integer
Original stored body character count, present when the returned body was truncated
Required range: x >= 0
thread.messages.agent_safe_content
boolean
True when raw headers, provider metadata, threat details, attachment metadata, and storage diagnostics were omitted and untrusted text fields were normalized to bounded plain text. This projection does not make email content trusted.
thread.messages.attachment_count
integer
Attachment count retained when agent_safe_content=true omits attachment metadata
Required range: x >= 0
thread.messages.delivery_address
string | null
Verified envelope delivery address, independent of visible To/Cc headers; null when unavailable.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Mermail","colors":{"primary":"#0e7f85","light":"#43c9cb","dark":"#0e7f85"},"logo":{"light":"https://mintcdn.com/mermail/lK0njDt4uJQSgy89/logo/light.svg?fit=max\u0026auto=format\u0026n=lK0njDt4uJQSgy89\u0026q=85\u0026s=d7334a3368c66f1a0fadf1a8fe4d0cae","dark":"https://mintcdn.com/mermail/lK0njDt4uJQSgy89/logo/dark.svg?fit=max\u0026auto=format\u0026n=lK0njDt4uJQSgy89\u0026q=85\u0026s=87d0a37feca26a317a2cc6724822d378"},"favicon":"https://mintcdn.com/mermail/lK0njDt4uJQSgy89/mermail-favicon.png?fit=max\u0026auto=format\u0026n=lK0njDt4uJQSgy89\u0026q=85\u0026s=40d9d2bcb61ee4afdeaa967965bbd27b","api":{"openapi":"openapi/openapi.json","params":{"expanded":"all"},"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","python","javascript","php","go","java","ruby"],"prefill":true,"autogenerate":true},"url":"full"},"navbar":{"links":[{"href":"mailto:contact@mermail.app","label":"Support"}],"primary":{"type":"button","label":"Open console","href":"https://console.mermail.app"}},"contextual":{"options":[],"display":"header"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Console","icon":"inbox","href":"https://console.mermail.app"},{"anchor":"Website","icon":"globe","href":"https://mermail.app"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"mermail","hasAudioNarration":false,"actualSubdomain":"mermail","customDomains":["docs.mermail.app"],"gitSource":{"type":"github","owner":"nudgen-marketing","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":true,"issues":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6afd59bb0749a80f90a7eb21","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":118},{"language":"default","tag":"Documentation","count":36},{"language":"default","tag":"Emails","count":28},{"language":"default","tag":"Integrations","count":17},{"language":"default","tag":"Guides","count":15},{"language":"default","tag":"Agent Wallet","count":12},{"language":"default","tag":"AI for agents","count":12},{"language":"default","tag":"RAG","count":11},{"language":"default","tag":"Webhooks","count":10},{"language":"default","tag":"Workspaces","count":9}],"searchSettings":{"showContentSnippets":true}},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":false}},"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":"[data-component-name=\"primary-header-button\"],#topbar-cta-button{color:#000!important}[data-component-name=\"primary-header-button\"] svg,#topbar-cta-button svg{display:none}"}]}
{"page":{"pagePath":"api-reference/emails/get-safe-email-and-thread-context","slug":"/api-reference/emails/get-safe-email-and-thread-context","pageMetadata":{"title":"Get safe email and thread context","description":"**Plans:** `Free` · `Developer` · `Enterprise`\n\nReturns the selected message plus an oldest-first, cursor-paginated thread page. This endpoint always strips sensitive transport metadata, sanitizes bodies to bounded plain text, and omits non-clean inbound bodies. Returned content remains untrusted reference data.\n\n**API credits:** 1 (read).","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Get safe email and thread context","openapi":"/openapi/openapi.json get /api/v1/mailboxes/{mailboxId}/emails/{emailId}/context","href":"/api-reference/emails/get-safe-email-and-thread-context","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Plans:\"\n }), \" \", _jsx(_components.code, {\n children: \"Free\"\n }), \" · \", _jsx(_components.code, {\n children: \"Developer\"\n }), \" · \", _jsx(_components.code, {\n children: \"Enterprise\"\n })]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Returns the selected message plus an oldest-first, cursor-paginated thread page. This endpoint always strips sensitive transport metadata, sanitizes bodies to bounded plain text, and omits non-clean inbound bodies. Returned content remains untrusted reference data.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"API credits:\"\n }), \" 1 (read).\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get safe email and thread context","description":"**Plans:** `Free` · `Developer` · `Enterprise`\n\nReturns the selected message plus an oldest-first, cursor-paginated thread page. This endpoint always strips sensitive transport metadata, sanitizes bodies to bounded plain text, and omits non-clean inbound bodies. Returned content remains untrusted reference data.\n\n**API credits:** 1 (read).","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Get safe email and thread context","openapi":"/openapi/openapi.json get /api/v1/mailboxes/{mailboxId}/emails/{emailId}/context","href":"/api-reference/emails/get-safe-email-and-thread-context","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Get safe email and thread context","description":"**Plans:** `Free` · `Developer` · `Enterprise`\n\nReturns the selected message plus an oldest-first, cursor-paginated thread page. This endpoint always strips sensitive transport metadata, sanitizes bodies to bounded plain text, and omits non-clean inbound bodies. Returned content remains untrusted reference data.\n\n**API credits:** 1 (read).","tags":["Emails"],"security":["bac8fe19-5ede-4e0e-9d79-a33db3c695b2"],"parameters":["78ac8bcf-ebd6-412f-a929-7be2a02b8635","01cbf23b-b0c2-487b-8a46-0be1b93874e9","93c87adb-9cc2-4ff3-a9f6-6a8139bfdfe3","9782fcfc-6d5e-411a-9307-fbf5600181a1","f6251864-ae3d-43db-b4ac-0c50e0cb3cd0"],"responses":{"200":"7ae8ce20-eebb-4daf-8534-6507f923eeea","400":"46fdfe02-e5d6-4efd-ab26-a8d6500d1a69","401":"3f698127-4e57-4051-a439-e477678b5a7e","402":"a5897033-4a03-4767-8bc1-e4f9c3ea0944","403":"07ec8baf-2279-40a2-b993-c8decf80f8f7","404":"378ed834-5c5e-4dae-bba8-b25bb56caafc","429":"8bd5921f-95eb-4901-b71a-dfd6e2cf278e"},"operationId":"getEmailContext","x-credits":1,"x-badges":[{"name":"Free","color":"green"},{"name":"Developer","color":"blue"},{"name":"Enterprise","color":"purple"}],"x-plan-access":["free","developer","enterprise"],"x-mint":{"metadata":{"tag":"All plans","title":"Get safe email and thread context","sidebarTitle":"Get safe email and thread context"}},"method":"get","type":"path","servers":["1af45da5-342a-45d2-b92f-08a7d8506a51"],"path":"/api/v1/mailboxes/{mailboxId}/emails/{emailId}/context","baseUrlOptions":["https://console.mermail.app"],"title":"Get safe email and thread context","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","php","go","java","ruby"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[],"urlDisplay":"full"},"dependencies":{"parameters":{"78ac8bcf-ebd6-412f-a929-7be2a02b8635":{"name":"mailboxId","in":"path","required":true,"description":"Mailbox public_id (UUID), hosted alias id, or current email","schema":{"type":"string","isRequired":true,"description":"Mailbox public_id (UUID), hosted alias id, or current email","uniqueKey":"","typeLabel":"string"},"example":"aaaaaaaa-bbbb-4ccc-8ddd-eeeeeeeeeeee"},"01cbf23b-b0c2-487b-8a46-0be1b93874e9":{"name":"emailId","in":"path","required":true,"description":"Message id from list or search results","schema":{"type":"string","isRequired":true,"description":"Message id from list or search results","uniqueKey":"","typeLabel":"string"},"example":"msg_7f3a2c1b"},"93c87adb-9cc2-4ff3-a9f6-6a8139bfdfe3":{"name":"limit","in":"query","required":false,"description":"Thread messages per page (default 20)","schema":{"type":"integer","minimum":1,"maximum":50,"default":20,"isRequired":false,"description":"Thread messages per page (default 20)","uniqueKey":"","typeLabel":"integer"}},"9782fcfc-6d5e-411a-9307-fbf5600181a1":{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from the preceding context page","schema":{"type":"string","maxLength":2048,"isRequired":false,"description":"Opaque next_cursor from the preceding context page","uniqueKey":"","typeLabel":"string"}},"f6251864-ae3d-43db-b4ac-0c50e0cb3cd0":{"name":"include_held","in":"query","required":false,"description":"Include mail held by auto-draft only for the active verification flow","schema":{"type":"boolean","default":false,"isRequired":false,"description":"Include mail held by auto-draft only for the active verification flow","uniqueKey":"","typeLabel":"boolean"}}},"responses":{"7ae8ce20-eebb-4daf-8534-6507f923eeea":{"description":"Safe email context","content":{"application/json":{"schema":{"type":"object","required":["email","thread"],"description":"Always-safe selected email and chronological thread page. Bodies are bounded plain text, sensitive transport metadata is removed, and non-clean inbound bodies are metadata-only. Content remains untrusted.","properties":{"email":{"type":"object","properties":{"id":{"type":"string","description":"Authoritative Mermail email id. Use this value as the `emailId` path argument and for pre-wait baselines.","uniqueKey":"email.id","typeLabel":"string"},"subject":{"type":"string","uniqueKey":"email.subject","typeLabel":"string"},"sender":{"type":"string","uniqueKey":"email.sender","typeLabel":"string"},"recipient":{"type":"string","uniqueKey":"email.recipient","typeLabel":"string"},"cc":{"oneOf":[{"type":"string","uniqueKey":"email.cc.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"email.cc.oneOf.1","typeLabel":"null"}],"uniqueKey":"email.cc","typeLabel":"string | null"},"bcc":{"oneOf":[{"type":"string","uniqueKey":"email.bcc.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"email.bcc.oneOf.1","typeLabel":"null"}],"uniqueKey":"email.bcc","typeLabel":"string | null"},"date":{"type":"string","format":"date-time","uniqueKey":"email.date","typeLabel":"string\u003cdate-time>"},"read":{"type":"boolean","uniqueKey":"email.read","typeLabel":"boolean"},"starred":{"type":"boolean","uniqueKey":"email.starred","typeLabel":"boolean"},"is_urgent":{"type":"boolean","uniqueKey":"email.is_urgent","typeLabel":"boolean"},"category":{"type":"string","uniqueKey":"email.category","typeLabel":"string"},"folder_id":{"type":"string","uniqueKey":"email.folder_id","typeLabel":"string"},"folder_name":{"type":"string","description":"Present on list and search responses","uniqueKey":"email.folder_name","typeLabel":"string"},"thread_id":{"oneOf":[{"type":"string","uniqueKey":"email.thread_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"email.thread_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"email.thread_id","typeLabel":"string | null"},"snippet":{"type":"string","uniqueKey":"email.snippet","typeLabel":"string"},"body":{"type":"string","description":"Full body on detail responses unless `metadata_only=true`; list/search responses can contain a preview","uniqueKey":"email.body","typeLabel":"string"},"in_reply_to":{"oneOf":[{"type":"string","uniqueKey":"email.in_reply_to.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"email.in_reply_to.oneOf.1","typeLabel":"null"}],"uniqueKey":"email.in_reply_to","typeLabel":"string | null"},"email_references":{"oneOf":[{"type":"string","uniqueKey":"email.email_references.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"email.email_references.oneOf.1","typeLabel":"null"}],"uniqueKey":"email.email_references","typeLabel":"string | null"},"delivery_status":{"oneOf":[{"type":"string","uniqueKey":"email.delivery_status.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"email.delivery_status.oneOf.1","typeLabel":"null"}],"uniqueKey":"email.delivery_status","typeLabel":"string | null"},"provider_metadata":{"oneOf":[{"type":"object","additionalProperties":true,"uniqueKey":"email.provider_metadata.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"uniqueKey":"email.provider_metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"email.provider_metadata","typeLabel":"object | null"},"message_id":{"oneOf":[{"type":"string","description":"Provider or RFC Message-ID metadata, retained only as secondary correlation. Do not use it in place of the Mermail `id` for resource paths or new baselines.","uniqueKey":"email.message_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Provider or RFC Message-ID metadata, retained only as secondary correlation. Do not use it in place of the Mermail `id` for resource paths or new baselines.","uniqueKey":"email.message_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"email.message_id","typeLabel":"string | null"},"raw_headers":{"oneOf":[{"type":"string","description":"Untrusted raw provider headers. Do not use headers alone as authorization.","uniqueKey":"email.raw_headers.oneOf.0","typeLabel":"string"},{"type":"null","description":"Untrusted raw provider headers. Do not use headers alone as authorization.","uniqueKey":"email.raw_headers.oneOf.1","typeLabel":"null"}],"uniqueKey":"email.raw_headers","typeLabel":"string | null"},"body_storage_status":{"type":"string","uniqueKey":"email.body_storage_status","typeLabel":"string"},"body_storage_message":{"type":"string","uniqueKey":"email.body_storage_message","typeLabel":"string"},"scan_status":{"oneOf":[{"type":"string","enum":["clean","flagged","skipped",null],"description":"Content scan outcome. Treat `flagged` as unsafe and `skipped` as unknown.","uniqueKey":"email.scan_status.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["clean","flagged","skipped",null],"description":"Content scan outcome. Treat `flagged` as unsafe and `skipped` as unknown.","uniqueKey":"email.scan_status.oneOf.1","typeLabel":"null"}],"uniqueKey":"email.scan_status","typeLabel":"enum\u003cstring> | null"},"scan_threats":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","uniqueKey":"email.scan_threats.items.[INDEX].url","typeLabel":"string"},"threat_type":{"type":"string","uniqueKey":"email.scan_threats.items.[INDEX].threat_type","typeLabel":"string"},"source":{"type":"string","enum":["body","attachment"],"uniqueKey":"email.scan_threats.items.[INDEX].source","typeLabel":"enum\u003cstring>"},"attachment_filename":{"type":"string","uniqueKey":"email.scan_threats.items.[INDEX].attachment_filename","typeLabel":"string"}},"uniqueKey":"email.scan_threats.items.[INDEX]","typeLabel":"object"},"uniqueKey":"email.scan_threats","typeLabel":"object[]"},"sender_authentication":{"type":"object","description":"Sender-authentication verdict derived only from a trusted receiving-provider signal. Raw Authentication-Results and From headers are never promoted to trusted evidence. The current connected providers do not expose a documented per-message verdict, so status is unknown; unknown is not a pass.","required":["status","spf","dkim","dmarc","inbound_provider","reason"],"properties":{"status":{"type":"string","enum":["pass","fail","unknown"],"isRequired":true,"uniqueKey":"email.sender_authentication.status","typeLabel":"enum\u003cstring>"},"spf":{"type":"string","enum":["pass","fail","unknown"],"isRequired":true,"uniqueKey":"email.sender_authentication.spf","typeLabel":"enum\u003cstring>"},"dkim":{"type":"string","enum":["pass","fail","unknown"],"isRequired":true,"uniqueKey":"email.sender_authentication.dkim","typeLabel":"enum\u003cstring>"},"dmarc":{"type":"string","enum":["pass","fail","unknown"],"isRequired":true,"uniqueKey":"email.sender_authentication.dmarc","typeLabel":"enum\u003cstring>"},"inbound_provider":{"oneOf":[{"type":"string","description":"Opaque Email-module inbound identifier; this is not itself a sender verdict.","isRequired":true,"uniqueKey":"email.sender_authentication.inbound_provider.oneOf.0","typeLabel":"string"},{"type":"null","description":"Opaque Email-module inbound identifier; this is not itself a sender verdict.","isRequired":true,"uniqueKey":"email.sender_authentication.inbound_provider.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"email.sender_authentication.inbound_provider","typeLabel":"string | null"},"reason":{"type":"string","enum":["provider_sender_authentication_verdict_unavailable","inbound_provider_unavailable"],"isRequired":true,"uniqueKey":"email.sender_authentication.reason","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"email.sender_authentication","typeLabel":"object"},"attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","uniqueKey":"email.attachments.items.[INDEX].id","typeLabel":"string"},"filename":{"type":"string","uniqueKey":"email.attachments.items.[INDEX].filename","typeLabel":"string"},"mimetype":{"type":"string","uniqueKey":"email.attachments.items.[INDEX].mimetype","typeLabel":"string"},"size":{"type":"integer","uniqueKey":"email.attachments.items.[INDEX].size","typeLabel":"integer"},"content_id":{"oneOf":[{"type":"string","uniqueKey":"email.attachments.items.[INDEX].content_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"email.attachments.items.[INDEX].content_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"email.attachments.items.[INDEX].content_id","typeLabel":"string | null"},"disposition":{"oneOf":[{"type":"string","uniqueKey":"email.attachments.items.[INDEX].disposition.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"email.attachments.items.[INDEX].disposition.oneOf.1","typeLabel":"null"}],"uniqueKey":"email.attachments.items.[INDEX].disposition","typeLabel":"string | null"}},"uniqueKey":"email.attachments.items.[INDEX]","typeLabel":"object"},"uniqueKey":"email.attachments","typeLabel":"object[]"},"content_omitted":{"type":"boolean","description":"True when metadata_only or an agent-safe scan gate omitted body, snippet, raw headers, and threat URLs","uniqueKey":"email.content_omitted","typeLabel":"boolean"},"content_omission_reason":{"type":"string","enum":["scan_status_not_clean"],"description":"Why an agent-safe detail or context response omitted body content","uniqueKey":"email.content_omission_reason","typeLabel":"enum\u003cstring>"},"content_truncated":{"type":"boolean","description":"True when `max_body_chars` shortened the returned body","uniqueKey":"email.content_truncated","typeLabel":"boolean"},"body_original_char_count":{"type":"integer","minimum":0,"description":"Original stored body character count, present when the returned body was truncated","uniqueKey":"email.body_original_char_count","typeLabel":"integer"},"agent_safe_content":{"type":"boolean","description":"True when raw headers, provider metadata, threat details, attachment metadata, and storage diagnostics were omitted and untrusted text fields were normalized to bounded plain text. This projection does not make email content trusted.","uniqueKey":"email.agent_safe_content","typeLabel":"boolean"},"attachment_count":{"type":"integer","minimum":0,"description":"Attachment count retained when `agent_safe_content=true` omits attachment metadata","uniqueKey":"email.attachment_count","typeLabel":"integer"},"delivery_address":{"oneOf":[{"type":"string","description":"Verified envelope delivery address, independent of visible To/Cc headers; null when unavailable.","uniqueKey":"email.delivery_address.oneOf.0","typeLabel":"string"},{"type":"null","description":"Verified envelope delivery address, independent of visible To/Cc headers; null when unavailable.","uniqueKey":"email.delivery_address.oneOf.1","typeLabel":"null"}],"uniqueKey":"email.delivery_address","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"email","typeLabel":"object"},"thread":{"type":"object","required":["id","messages","total_count","has_more","next_cursor"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"thread.id","typeLabel":"string"},"messages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Authoritative Mermail email id. Use this value as the `emailId` path argument and for pre-wait baselines.","uniqueKey":"thread.messages.items.[INDEX].id","typeLabel":"string"},"subject":{"type":"string","uniqueKey":"thread.messages.items.[INDEX].subject","typeLabel":"string"},"sender":{"type":"string","uniqueKey":"thread.messages.items.[INDEX].sender","typeLabel":"string"},"recipient":{"type":"string","uniqueKey":"thread.messages.items.[INDEX].recipient","typeLabel":"string"},"cc":{"oneOf":[{"type":"string","uniqueKey":"thread.messages.items.[INDEX].cc.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"thread.messages.items.[INDEX].cc.oneOf.1","typeLabel":"null"}],"uniqueKey":"thread.messages.items.[INDEX].cc","typeLabel":"string | null"},"bcc":{"oneOf":[{"type":"string","uniqueKey":"thread.messages.items.[INDEX].bcc.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"thread.messages.items.[INDEX].bcc.oneOf.1","typeLabel":"null"}],"uniqueKey":"thread.messages.items.[INDEX].bcc","typeLabel":"string | null"},"date":{"type":"string","format":"date-time","uniqueKey":"thread.messages.items.[INDEX].date","typeLabel":"string\u003cdate-time>"},"read":{"type":"boolean","uniqueKey":"thread.messages.items.[INDEX].read","typeLabel":"boolean"},"starred":{"type":"boolean","uniqueKey":"thread.messages.items.[INDEX].starred","typeLabel":"boolean"},"is_urgent":{"type":"boolean","uniqueKey":"thread.messages.items.[INDEX].is_urgent","typeLabel":"boolean"},"category":{"type":"string","uniqueKey":"thread.messages.items.[INDEX].category","typeLabel":"string"},"folder_id":{"type":"string","uniqueKey":"thread.messages.items.[INDEX].folder_id","typeLabel":"string"},"folder_name":{"type":"string","description":"Present on list and search responses","uniqueKey":"thread.messages.items.[INDEX].folder_name","typeLabel":"string"},"thread_id":{"oneOf":[{"type":"string","uniqueKey":"thread.messages.items.[INDEX].thread_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"thread.messages.items.[INDEX].thread_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"thread.messages.items.[INDEX].thread_id","typeLabel":"string | null"},"snippet":{"type":"string","uniqueKey":"thread.messages.items.[INDEX].snippet","typeLabel":"string"},"body":{"type":"string","description":"Full body on detail responses unless `metadata_only=true`; list/search responses can contain a preview","uniqueKey":"thread.messages.items.[INDEX].body","typeLabel":"string"},"in_reply_to":{"oneOf":[{"type":"string","uniqueKey":"thread.messages.items.[INDEX].in_reply_to.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"thread.messages.items.[INDEX].in_reply_to.oneOf.1","typeLabel":"null"}],"uniqueKey":"thread.messages.items.[INDEX].in_reply_to","typeLabel":"string | null"},"email_references":{"oneOf":[{"type":"string","uniqueKey":"thread.messages.items.[INDEX].email_references.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"thread.messages.items.[INDEX].email_references.oneOf.1","typeLabel":"null"}],"uniqueKey":"thread.messages.items.[INDEX].email_references","typeLabel":"string | null"},"delivery_status":{"oneOf":[{"type":"string","uniqueKey":"thread.messages.items.[INDEX].delivery_status.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"thread.messages.items.[INDEX].delivery_status.oneOf.1","typeLabel":"null"}],"uniqueKey":"thread.messages.items.[INDEX].delivery_status","typeLabel":"string | null"},"provider_metadata":{"oneOf":[{"type":"object","additionalProperties":true,"uniqueKey":"thread.messages.items.[INDEX].provider_metadata.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"uniqueKey":"thread.messages.items.[INDEX].provider_metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"thread.messages.items.[INDEX].provider_metadata","typeLabel":"object | null"},"message_id":{"oneOf":[{"type":"string","description":"Provider or RFC Message-ID metadata, retained only as secondary correlation. Do not use it in place of the Mermail `id` for resource paths or new baselines.","uniqueKey":"thread.messages.items.[INDEX].message_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Provider or RFC Message-ID metadata, retained only as secondary correlation. Do not use it in place of the Mermail `id` for resource paths or new baselines.","uniqueKey":"thread.messages.items.[INDEX].message_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"thread.messages.items.[INDEX].message_id","typeLabel":"string | null"},"raw_headers":{"oneOf":[{"type":"string","description":"Untrusted raw provider headers. Do not use headers alone as authorization.","uniqueKey":"thread.messages.items.[INDEX].raw_headers.oneOf.0","typeLabel":"string"},{"type":"null","description":"Untrusted raw provider headers. Do not use headers alone as authorization.","uniqueKey":"thread.messages.items.[INDEX].raw_headers.oneOf.1","typeLabel":"null"}],"uniqueKey":"thread.messages.items.[INDEX].raw_headers","typeLabel":"string | null"},"body_storage_status":{"type":"string","uniqueKey":"thread.messages.items.[INDEX].body_storage_status","typeLabel":"string"},"body_storage_message":{"type":"string","uniqueKey":"thread.messages.items.[INDEX].body_storage_message","typeLabel":"string"},"scan_status":{"oneOf":[{"type":"string","enum":["clean","flagged","skipped",null],"description":"Content scan outcome. Treat `flagged` as unsafe and `skipped` as unknown.","uniqueKey":"thread.messages.items.[INDEX].scan_status.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["clean","flagged","skipped",null],"description":"Content scan outcome. Treat `flagged` as unsafe and `skipped` as unknown.","uniqueKey":"thread.messages.items.[INDEX].scan_status.oneOf.1","typeLabel":"null"}],"uniqueKey":"thread.messages.items.[INDEX].scan_status","typeLabel":"enum\u003cstring> | null"},"scan_threats":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","uniqueKey":"thread.messages.items.[INDEX].scan_threats.items.[INDEX].url","typeLabel":"string"},"threat_type":{"type":"string","uniqueKey":"thread.messages.items.[INDEX].scan_threats.items.[INDEX].threat_type","typeLabel":"string"},"source":{"type":"string","enum":["body","attachment"],"uniqueKey":"thread.messages.items.[INDEX].scan_threats.items.[INDEX].source","typeLabel":"enum\u003cstring>"},"attachment_filename":{"type":"string","uniqueKey":"thread.messages.items.[INDEX].scan_threats.items.[INDEX].attachment_filename","typeLabel":"string"}},"uniqueKey":"thread.messages.items.[INDEX].scan_threats.items.[INDEX]","typeLabel":"object"},"uniqueKey":"thread.messages.items.[INDEX].scan_threats","typeLabel":"object[]"},"sender_authentication":{"type":"object","description":"Sender-authentication verdict derived only from a trusted receiving-provider signal. Raw Authentication-Results and From headers are never promoted to trusted evidence. The current connected providers do not expose a documented per-message verdict, so status is unknown; unknown is not a pass.","required":["status","spf","dkim","dmarc","inbound_provider","reason"],"properties":{"status":{"type":"string","enum":["pass","fail","unknown"],"isRequired":true,"uniqueKey":"thread.messages.items.[INDEX].sender_authentication.status","typeLabel":"enum\u003cstring>"},"spf":{"type":"string","enum":["pass","fail","unknown"],"isRequired":true,"uniqueKey":"thread.messages.items.[INDEX].sender_authentication.spf","typeLabel":"enum\u003cstring>"},"dkim":{"type":"string","enum":["pass","fail","unknown"],"isRequired":true,"uniqueKey":"thread.messages.items.[INDEX].sender_authentication.dkim","typeLabel":"enum\u003cstring>"},"dmarc":{"type":"string","enum":["pass","fail","unknown"],"isRequired":true,"uniqueKey":"thread.messages.items.[INDEX].sender_authentication.dmarc","typeLabel":"enum\u003cstring>"},"inbound_provider":{"oneOf":[{"type":"string","description":"Opaque Email-module inbound identifier; this is not itself a sender verdict.","isRequired":true,"uniqueKey":"thread.messages.items.[INDEX].sender_authentication.inbound_provider.oneOf.0","typeLabel":"string"},{"type":"null","description":"Opaque Email-module inbound identifier; this is not itself a sender verdict.","isRequired":true,"uniqueKey":"thread.messages.items.[INDEX].sender_authentication.inbound_provider.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"thread.messages.items.[INDEX].sender_authentication.inbound_provider","typeLabel":"string | null"},"reason":{"type":"string","enum":["provider_sender_authentication_verdict_unavailable","inbound_provider_unavailable"],"isRequired":true,"uniqueKey":"thread.messages.items.[INDEX].sender_authentication.reason","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"thread.messages.items.[INDEX].sender_authentication","typeLabel":"object"},"attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","uniqueKey":"thread.messages.items.[INDEX].attachments.items.[INDEX].id","typeLabel":"string"},"filename":{"type":"string","uniqueKey":"thread.messages.items.[INDEX].attachments.items.[INDEX].filename","typeLabel":"string"},"mimetype":{"type":"string","uniqueKey":"thread.messages.items.[INDEX].attachments.items.[INDEX].mimetype","typeLabel":"string"},"size":{"type":"integer","uniqueKey":"thread.messages.items.[INDEX].attachments.items.[INDEX].size","typeLabel":"integer"},"content_id":{"oneOf":[{"type":"string","uniqueKey":"thread.messages.items.[INDEX].attachments.items.[INDEX].content_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"thread.messages.items.[INDEX].attachments.items.[INDEX].content_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"thread.messages.items.[INDEX].attachments.items.[INDEX].content_id","typeLabel":"string | null"},"disposition":{"oneOf":[{"type":"string","uniqueKey":"thread.messages.items.[INDEX].attachments.items.[INDEX].disposition.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"thread.messages.items.[INDEX].attachments.items.[INDEX].disposition.oneOf.1","typeLabel":"null"}],"uniqueKey":"thread.messages.items.[INDEX].attachments.items.[INDEX].disposition","typeLabel":"string | null"}},"uniqueKey":"thread.messages.items.[INDEX].attachments.items.[INDEX]","typeLabel":"object"},"uniqueKey":"thread.messages.items.[INDEX].attachments","typeLabel":"object[]"},"content_omitted":{"type":"boolean","description":"True when metadata_only or an agent-safe scan gate omitted body, snippet, raw headers, and threat URLs","uniqueKey":"thread.messages.items.[INDEX].content_omitted","typeLabel":"boolean"},"content_omission_reason":{"type":"string","enum":["scan_status_not_clean"],"description":"Why an agent-safe detail or context response omitted body content","uniqueKey":"thread.messages.items.[INDEX].content_omission_reason","typeLabel":"enum\u003cstring>"},"content_truncated":{"type":"boolean","description":"True when `max_body_chars` shortened the returned body","uniqueKey":"thread.messages.items.[INDEX].content_truncated","typeLabel":"boolean"},"body_original_char_count":{"type":"integer","minimum":0,"description":"Original stored body character count, present when the returned body was truncated","uniqueKey":"thread.messages.items.[INDEX].body_original_char_count","typeLabel":"integer"},"agent_safe_content":{"type":"boolean","description":"True when raw headers, provider metadata, threat details, attachment metadata, and storage diagnostics were omitted and untrusted text fields were normalized to bounded plain text. This projection does not make email content trusted.","uniqueKey":"thread.messages.items.[INDEX].agent_safe_content","typeLabel":"boolean"},"attachment_count":{"type":"integer","minimum":0,"description":"Attachment count retained when `agent_safe_content=true` omits attachment metadata","uniqueKey":"thread.messages.items.[INDEX].attachment_count","typeLabel":"integer"},"delivery_address":{"oneOf":[{"type":"string","description":"Verified envelope delivery address, independent of visible To/Cc headers; null when unavailable.","uniqueKey":"thread.messages.items.[INDEX].delivery_address.oneOf.0","typeLabel":"string"},{"type":"null","description":"Verified envelope delivery address, independent of visible To/Cc headers; null when unavailable.","uniqueKey":"thread.messages.items.[INDEX].delivery_address.oneOf.1","typeLabel":"null"}],"uniqueKey":"thread.messages.items.[INDEX].delivery_address","typeLabel":"string | null"}},"uniqueKey":"thread.messages.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"thread.messages","typeLabel":"object[]"},"total_count":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"thread.total_count","typeLabel":"integer"},"has_more":{"type":"boolean","isRequired":true,"uniqueKey":"thread.has_more","typeLabel":"boolean"},"next_cursor":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"thread.next_cursor.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"thread.next_cursor.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"thread.next_cursor","typeLabel":"string | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"thread","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"example":{"email":{"id":"msg_7f3a2c1b","subject":"Order question","sender":"alice@example.com","recipient":"support@mail.acme.com","cc":null,"bcc":null,"date":"2026-07-14T09:00:00.000Z","read":false,"starred":false,"is_urgent":false,"category":"customer_support","body":"Hi, where is my order?","folder_id":"INBOX","folder_name":"Inbox","thread_id":"thr_9aabb","snippet":"Hi, where is my order?","scan_status":null,"attachments":[]},"thread":{"id":"thread_7f3a2c1b","messages":[{"id":"msg_7f3a2c1b","subject":"Order question","sender":"alice@example.com","recipient":"support@mail.acme.com","cc":null,"bcc":null,"date":"2026-07-14T09:00:00.000Z","read":false,"starred":false,"is_urgent":false,"category":"customer_support","body":"Hi, where is my order?","folder_id":"INBOX","folder_name":"Inbox","thread_id":"thr_9aabb","snippet":"Hi, where is my order?","scan_status":null,"attachments":[]}],"total_count":1,"has_more":false,"next_cursor":null}},"examples":{"Example":{"title":"Example","value":{"email":{"id":"msg_7f3a2c1b","subject":"Order question","sender":"alice@example.com","recipient":"support@mail.acme.com","cc":null,"bcc":null,"date":"2026-07-14T09:00:00.000Z","read":false,"starred":false,"is_urgent":false,"category":"customer_support","body":"Hi, where is my order?","folder_id":"INBOX","folder_name":"Inbox","thread_id":"thr_9aabb","snippet":"Hi, where is my order?","scan_status":null,"attachments":[]},"thread":{"id":"thread_7f3a2c1b","messages":[{"id":"msg_7f3a2c1b","subject":"Order question","sender":"alice@example.com","recipient":"support@mail.acme.com","cc":null,"bcc":null,"date":"2026-07-14T09:00:00.000Z","read":false,"starred":false,"is_urgent":false,"category":"customer_support","body":"Hi, where is my order?","folder_id":"INBOX","folder_name":"Inbox","thread_id":"thr_9aabb","snippet":"Hi, where is my order?","scan_status":null,"attachments":[]}],"total_count":1,"has_more":false,"next_cursor":null}}}},"exampleType":"examples"}},"exampleType":"examples"},"46fdfe02-e5d6-4efd-ab26-a8d6500d1a69":{"description":"Invalid limit or cursor","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","example":"Unauthorized","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Invalid cursor"},"examples":{"Example":{"title":"Example","value":{"error":"Invalid cursor"}}},"exampleType":"examples"}},"exampleType":"examples"},"3f698127-4e57-4051-a439-e477678b5a7e":{"description":"Missing, invalid, expired, or revoked API key / token","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","example":"Unauthorized","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Unauthorized"},"examples":{"Example":{"title":"Example","value":{"error":"Unauthorized"}}},"exampleType":"examples"}},"exampleType":"examples"},"a5897033-4a03-4767-8bc1-e4f9c3ea0944":{"description":"API credits exhausted for this workspace period","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","example":"Unauthorized","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Invalid request"},"examples":{"Example":{"title":"Example","value":{"error":"Invalid request"}}},"exampleType":"examples"}},"exampleType":"examples"},"07ec8baf-2279-40a2-b993-c8decf80f8f7":{"description":"Forbidden — plan gate, wrong workspace, or missing role","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","example":"Unauthorized","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Forbidden"},"examples":{"Example":{"title":"Example","value":{"error":"Forbidden"}}},"exampleType":"examples"}},"exampleType":"examples"},"378ed834-5c5e-4dae-bba8-b25bb56caafc":{"description":"Email not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","example":"Unauthorized","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Email not found"},"examples":{"Example":{"title":"Example","value":{"error":"Email not found"}}},"exampleType":"examples"}},"exampleType":"examples"},"8bd5921f-95eb-4901-b71a-dfd6e2cf278e":{"description":"Rate limit exceeded (workspace RPM or email send limits)","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","example":"Unauthorized","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Too many requests"},"examples":{"Example":{"title":"Example","value":{"error":"Too many requests"}}},"exampleType":"examples"}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds until the rate limit window resets"}},"exampleType":"examples"}},"security":{"bac8fe19-5ede-4e0e-9d79-a33db3c695b2":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key (`sk-proj-…`) from Settings → API Keys. Required for sold API calls outside the Mermail console.","scopes":[],"schemeName":"apiKeyAuth"}}},"servers":{"1af45da5-342a-45d2-b92f-08a7d8506a51":{"url":"https://console.mermail.app","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key (`sk-proj-…`) from Settings → API Keys. Required for sold API calls outside the Mermail console.","scopes":[],"schemeName":"apiKeyAuth"},"schema":{"title":"x-api-key","type":"string","description":"API key (`sk-proj-…`) from Settings → API Keys. Required for sold API calls outside the Mermail console.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKeyAuth","name":"x-api-key"}],"title":"apiKeyAuth"}]},"originalFileLocation":"openapi/openapi.json"},"subdomain":"mermail","siteName":"Mermail","title":"Get safe email and thread context - Mermail","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-23T02:51:34.082Z","originalFileLocation":"api-reference/emails/get-safe-email-and-thread-context.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Plans: Free · Developer · Enterprise Returns the selected message plus an oldest-first, cursor-paginated thread page. This endpoint always strips sensitive transport metadata, sanitizes bodies to bounded plain text, and omits non-clean inbound bodies. Returned content remains untrusted reference data. API credits: 1 (read).\">\u003cmeta data-mint-head name=\"application-name\" content=\"Mermail\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/mermail/-cEWVlZZp-vScwFs/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/mermail/-cEWVlZZp-vScwFs/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/mermail/-cEWVlZZp-vScwFs/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/mermail/-cEWVlZZp-vScwFs/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/mermail/-cEWVlZZp-vScwFs/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/mermail/-cEWVlZZp-vScwFs/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/mermail/-cEWVlZZp-vScwFs/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/mermail/-cEWVlZZp-vScwFs/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/mermail/-cEWVlZZp-vScwFs/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get safe email and thread context - Mermail\">\u003cmeta data-mint-head property=\"og:description\" content=\"Plans: Free · Developer · Enterprise Returns the selected message plus an oldest-first, cursor-paginated thread page. This endpoint always strips sensitive transport metadata, sanitizes bodies to bounded plain text, and omits non-clean inbound bodies. Returned content remains untrusted reference data. API credits: 1 (read).\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Mermail\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.mermail.app/api-reference/emails/get-safe-email-and-thread-context\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://mermail.mintlify.site/_mintlify/api/og/v2?division=Emails\u0026amp;title=Get+safe+email+and+thread+context\u0026amp;description=**Plans%3A**+%60Free%60+%C2%B7+%60Developer%60+%C2%B7+%60Enterprise%60%0A%0AReturns+the+selected+message+plus+an+oldest-first%2C+cursor-paginated+thread+page.+This+endpoint+always+strips+sen\u0026amp;theme=bb80c928da38fa6a33524e4e\u0026amp;signature=1d40f2f785815b414a94213754704f58dd5201cd93a10b638d203c55a5188e85\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get safe email and thread context - Mermail\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Plans: Free · Developer · Enterprise Returns the selected message plus an oldest-first, cursor-paginated thread page. This endpoint always strips sensitive transport metadata, sanitizes bodies to bounded plain text, and omits non-clean inbound bodies. Returned content remains untrusted reference data. API credits: 1 (read).\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://mermail.mintlify.site/_mintlify/api/og/v2?division=Emails\u0026amp;title=Get+safe+email+and+thread+context\u0026amp;description=**Plans%3A**+%60Free%60+%C2%B7+%60Developer%60+%C2%B7+%60Enterprise%60%0A%0AReturns+the+selected+message+plus+an+oldest-first%2C+cursor-paginated+thread+page.+This+endpoint+always+strips+sen\u0026amp;theme=bb80c928da38fa6a33524e4e\u0026amp;signature=1d40f2f785815b414a94213754704f58dd5201cd93a10b638d203c55a5188e85\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/mermail/-cEWVlZZp-vScwFs/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Mermail\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0e7f85\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.mermail.app/api-reference/emails/get-safe-email-and-thread-context\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/emails/get-safe-email-and-thread-context.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.mermail.app/#organization\",\"name\":\"Mermail\",\"url\":\"https://docs.mermail.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/mermail/lK0njDt4uJQSgy89/logo/light.svg?fit=max\u0026auto=format\u0026n=lK0njDt4uJQSgy89\u0026q=85\u0026s=d7334a3368c66f1a0fadf1a8fe4d0cae\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.mermail.app#website\",\"name\":\"Mermail\",\"url\":\"https://docs.mermail.app\",\"publisher\":{\"@id\":\"https://docs.mermail.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.mermail.app/api-reference/emails/get-safe-email-and-thread-context#webpage\",\"url\":\"https://docs.mermail.app/api-reference/emails/get-safe-email-and-thread-context\",\"name\":\"Get safe email and thread context\",\"description\":\"Plans: Free · Developer · Enterprise Returns the selected message plus an oldest-first, cursor-paginated thread page. This endpoint always strips sensitive transport metadata, sanitizes bodies to bounded plain text, and omits non-clean inbound bodies. Returned content remains untrusted reference data. API credits: 1 (read).\",\"dateModified\":\"2026-10-23T02:51:34.082Z\",\"isPartOf\":{\"@id\":\"https://docs.mermail.app#website\"},\"breadcrumb\":{\"@id\":\"https://docs.mermail.app/api-reference/emails/get-safe-email-and-thread-context#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.mermail.app/api-reference/emails/get-safe-email-and-thread-context#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Emails\",\"item\":\"https://docs.mermail.app/api-reference/emails/list-emails\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get safe email and thread context\",\"item\":\"https://docs.mermail.app/api-reference/emails/get-safe-email-and-thread-context\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.mermail.app/api-reference/emails/get-safe-email-and-thread-context#apireference\",\"headline\":\"Get safe email and thread context\",\"name\":\"Get safe email and thread context\",\"description\":\"Plans: Free · Developer · Enterprise Returns the selected message plus an oldest-first, cursor-paginated thread page. This endpoint always strips sensitive transport metadata, sanitizes bodies to bounded plain text, and omits non-clean inbound bodies. Returned content remains untrusted reference data. API credits: 1 (read).\",\"url\":\"https://docs.mermail.app/api-reference/emails/get-safe-email-and-thread-context\",\"mainEntityOfPage\":{\"@id\":\"https://docs.mermail.app/api-reference/emails/get-safe-email-and-thread-context#webpage\"},\"dateModified\":\"2026-10-23T02:51:34.082Z\",\"publisher\":{\"@id\":\"https://docs.mermail.app/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.mermail.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Mermail\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Mermail\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/emails/get-safe-email-and-thread-context.md","siteName":"Mermail","nav":{"global":{"anchors":[{"anchor":"Console","icon":"inbox","href":"https://console.mermail.app"},{"anchor":"Website","icon":"globe","href":"https://mermail.app"}]},"tabs":[{"tab":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":""}]},{"tab":"AI for agents","icon":"sparkles","pages":[{"title":"AI for agents","href":"/ai/overview"}]},{"tab":"Agent Wallet","icon":"wallet","pages":[{"title":"Agent Wallet","href":"/agent-wallet/overview"}]},{"tab":"API Reference","icon":"square-terminal","groups":[{"group":"Getting started","pages":[{"title":"API overview","icon":"code","href":"/api-reference/overview"},{"title":"Authentication","icon":"key","href":"/api-reference/authentication"},{"title":"Discovery","icon":"radar","href":"/api-reference/discovery"}]},{"group":"Usage","pages":[{"title":"Get API credit usage","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Get API credit usage","openapi":"/openapi/openapi.json get /api/v1/workspaces/{workspaceId}/usage/credits","href":"/api-reference/usage/get-api-credit-usage"},{"title":"Get email usage","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Get email usage","openapi":"/openapi/openapi.json get /api/v1/workspaces/{workspaceId}/usage/email","href":"/api-reference/usage/get-email-usage"}]},{"group":"Workspaces","pages":[{"title":"List workspaces","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"List workspaces","openapi":"/openapi/openapi.json get /api/v1/workspaces","href":"/api-reference/workspaces/list-workspaces"},{"title":"Get workspace","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Get workspace","openapi":"/openapi/openapi.json get /api/v1/workspaces/{workspaceId}","href":"/api-reference/workspaces/get-workspace"},{"title":"Update workspace","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Update workspace","openapi":"/openapi/openapi.json put /api/v1/workspaces/{workspaceId}","href":"/api-reference/workspaces/update-workspace"},{"title":"Get workspace storage","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Get workspace storage","openapi":"/openapi/openapi.json get /api/v1/workspaces/{workspaceId}/storage","href":"/api-reference/workspaces/get-workspace-storage"},{"title":"List workspace members","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"List workspace members","openapi":"/openapi/openapi.json get /api/v1/workspaces/{workspaceId}/members","href":"/api-reference/workspaces/list-workspace-members"},{"title":"Update member role","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Update member role","openapi":"/openapi/openapi.json put /api/v1/workspaces/{workspaceId}/members/{memberId}","href":"/api-reference/workspaces/update-member-role"},{"title":"Remove member","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Remove member","openapi":"/openapi/openapi.json delete /api/v1/workspaces/{workspaceId}/members/{memberId}","href":"/api-reference/workspaces/remove-member"},{"title":"Invite member","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Invite member","openapi":"/openapi/openapi.json post /api/v1/workspaces/{workspaceId}/invites","href":"/api-reference/workspaces/invite-member"},{"title":"Resend invite","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Resend invite","openapi":"/openapi/openapi.json post /api/v1/workspaces/{workspaceId}/invites/{inviteId}/resend","href":"/api-reference/workspaces/resend-invite"}]},{"group":"Domains","pages":[{"title":"List email domains","deprecated":null,"version":null,"tag":"Developer+","sidebarTitle":"List email domains","openapi":"/openapi/openapi.json get /api/v1/workspaces/{workspaceId}/email-domains","href":"/api-reference/domains/list-email-domains"},{"title":"Add email domain","deprecated":null,"version":null,"tag":"Developer+","sidebarTitle":"Add email domain","openapi":"/openapi/openapi.json post /api/v1/workspaces/{workspaceId}/email-domains","href":"/api-reference/domains/add-email-domain"},{"title":"Delete email domain","deprecated":null,"version":null,"tag":"Developer+","sidebarTitle":"Delete email domain","openapi":"/openapi/openapi.json delete /api/v1/workspaces/{workspaceId}/email-domains/{domainId}","href":"/api-reference/domains/delete-email-domain"},{"title":"Verify email domain","deprecated":null,"version":null,"tag":"Developer+","sidebarTitle":"Verify email domain","openapi":"/openapi/openapi.json post /api/v1/workspaces/{workspaceId}/email-domains/{domainId}/verify","href":"/api-reference/domains/verify-email-domain"}]},{"group":"Mailboxes","pages":[{"title":"List workspace mailboxes","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"List workspace mailboxes","openapi":"/openapi/openapi.json get /api/v1/workspaces/{workspaceId}/mailboxes","href":"/api-reference/mailboxes/list-workspace-mailboxes"},{"title":"List mailboxes","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"List mailboxes","openapi":"/openapi/openapi.json get /api/v1/mailboxes","href":"/api-reference/mailboxes/list-mailboxes"},{"title":"Create mailbox","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Create mailbox","openapi":"/openapi/openapi.json post /api/v1/mailboxes","href":"/api-reference/mailboxes/create-mailbox"},{"title":"Get mailbox","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Get mailbox","openapi":"/openapi/openapi.json get /api/v1/mailboxes/{mailboxId}","href":"/api-reference/mailboxes/get-mailbox"},{"title":"Update mailbox settings","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Update mailbox settings","openapi":"/openapi/openapi.json put /api/v1/mailboxes/{mailboxId}","href":"/api-reference/mailboxes/update-mailbox-settings"},{"title":"Get mailbox storage","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Get mailbox storage","openapi":"/openapi/openapi.json get /api/v1/mailboxes/{mailboxId}/storage","href":"/api-reference/mailboxes/get-mailbox-storage"},{"title":"List saved and blocked plus aliases","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /api/v1/mailboxes/{mailboxId}/aliases","href":"/api-reference/list-saved-and-blocked-plus-aliases"},{"title":"Save a plus alias shortcut","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/aliases","href":"/api-reference/save-a-plus-alias-shortcut"},{"title":"Update, block, or unblock a plus alias","deprecated":null,"version":null,"openapi":"/openapi/openapi.json put /api/v1/mailboxes/{mailboxId}/aliases/{tag}","href":"/api-reference/update-block-or-unblock-a-plus-alias"},{"title":"Remove a saved alias shortcut","deprecated":null,"version":null,"openapi":"/openapi/openapi.json delete /api/v1/mailboxes/{mailboxId}/aliases/{tag}","href":"/api-reference/remove-a-saved-alias-shortcut"}]},{"group":"Emails","pages":[{"title":"List emails","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"List emails","openapi":"/openapi/openapi.json get /api/v1/mailboxes/{mailboxId}/emails","href":"/api-reference/emails/list-emails"},{"title":"Send email","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Send email","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/emails","href":"/api-reference/emails/send-email"},{"title":"Get email","description":"**Plans:** `Free` · `Developer` · `Enterprise`\n\nFetches a single email with body and metadata without marking it read. Set `metadata_only=true` to omit body content, `require_scan_status=clean` to expose the body only for a clean stored message, `max_body_chars` to bound the returned body without mutating storage, and `agent_safe_content=true` to remove sensitive metadata and normalize untrusted text to bounded plain text. A scan-status mismatch returns safe metadata with `content_omitted` and `content_omission_reason` instead of a false not-found. `include_held=true` is intended only for an explicitly scoped verification wait. All controls are optional and preserve the existing full response by default.\n\n**API credits:** 1 (read).","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Get email","openapi":"/openapi/openapi.json get /api/v1/mailboxes/{mailboxId}/emails/{emailId}","href":"/api-reference/emails/get-email"},{"title":"Get safe email and thread context","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Get safe email and thread context","openapi":"/openapi/openapi.json get /api/v1/mailboxes/{mailboxId}/emails/{emailId}/context","href":"/api-reference/emails/get-safe-email-and-thread-context"},{"title":"Update email","description":"**Plans:** `Free` · `Developer` · `Enterprise`\n\nUpdates flags such as read/starred or moves metadata.\n\n**API credits:** 2 (write).","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Update email","openapi":"/openapi/openapi.json put /api/v1/mailboxes/{mailboxId}/emails/{emailId}","href":"/api-reference/emails/update-email"},{"title":"Delete email","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Delete email","openapi":"/openapi/openapi.json delete /api/v1/mailboxes/{mailboxId}/emails/{emailId}","href":"/api-reference/emails/delete-email"},{"title":"Bulk delete emails","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Bulk delete emails","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/emails/bulk-delete","href":"/api-reference/emails/bulk-delete-emails"},{"title":"Bulk mark emails read","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Bulk mark emails read","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/emails/bulk-read","href":"/api-reference/emails/bulk-mark-emails-read"},{"title":"Bulk move emails","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Bulk move emails","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/emails/bulk-move","href":"/api-reference/emails/bulk-move-emails"},{"title":"Move email","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Move email","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/emails/{emailId}/move","href":"/api-reference/emails/move-email"},{"title":"Reply to email","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Reply to email","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/emails/{emailId}/reply","href":"/api-reference/emails/reply-to-email"},{"title":"Forward email","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Forward email","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/emails/{emailId}/forward","href":"/api-reference/emails/forward-email"},{"title":"Download attachment","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Download attachment","openapi":"/openapi/openapi.json get /api/v1/mailboxes/{mailboxId}/emails/{emailId}/attachments/{attachmentId}","href":"/api-reference/emails/download-attachment"},{"title":"Save draft","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Save draft","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/drafts","href":"/api-reference/emails/save-draft"},{"title":"Regenerate draft with AI","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Regenerate draft with AI","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/drafts/regenerate","href":"/api-reference/emails/regenerate-draft-with-ai"},{"title":"Schedule send","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Schedule send","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/scheduled-sends","href":"/api-reference/emails/schedule-send"},{"title":"Empty trash","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Empty trash","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/trash/empty","href":"/api-reference/emails/empty-trash"},{"title":"Get thread","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Get thread","openapi":"/openapi/openapi.json get /api/v1/mailboxes/{mailboxId}/threads/{threadId}","href":"/api-reference/emails/get-thread"},{"title":"Mark thread read","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Mark thread read","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/threads/{threadId}/read","href":"/api-reference/emails/mark-thread-read"},{"title":"List folders","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"List folders","openapi":"/openapi/openapi.json get /api/v1/mailboxes/{mailboxId}/folders","href":"/api-reference/emails/list-folders"},{"title":"Create folder","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Create folder","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/folders","href":"/api-reference/emails/create-folder"},{"title":"Update folder","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Update folder","openapi":"/openapi/openapi.json put /api/v1/mailboxes/{mailboxId}/folders/{folderId}","href":"/api-reference/emails/update-folder"},{"title":"Delete folder","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Delete folder","openapi":"/openapi/openapi.json delete /api/v1/mailboxes/{mailboxId}/folders/{folderId}","href":"/api-reference/emails/delete-folder"},{"title":"Search emails","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Search emails","openapi":"/openapi/openapi.json get /api/v1/mailboxes/{mailboxId}/search","href":"/api-reference/emails/search-emails"},{"title":"List custom labels","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"List custom labels","openapi":"/openapi/openapi.json get /api/v1/mailboxes/{mailboxId}/custom-labels","href":"/api-reference/emails/list-custom-labels"},{"title":"Create custom label","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Create custom label","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/custom-labels","href":"/api-reference/emails/create-custom-label"},{"title":"Update custom label","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Update custom label","openapi":"/openapi/openapi.json put /api/v1/mailboxes/{mailboxId}/custom-labels/{labelId}","href":"/api-reference/emails/update-custom-label"},{"title":"Delete custom label","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Delete custom label","openapi":"/openapi/openapi.json delete /api/v1/mailboxes/{mailboxId}/custom-labels/{labelId}","href":"/api-reference/emails/delete-custom-label"}]},{"group":"Webhooks","pages":[{"title":"Webhook payloads and verification","icon":"webhook","href":"/api-reference/webhooks"},{"title":"List webhooks","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"List webhooks","openapi":"/openapi/openapi.json get /api/v1/workspaces/{workspaceId}/webhooks","href":"/api-reference/webhooks/list-webhooks"},{"title":"Create webhook","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Create webhook","openapi":"/openapi/openapi.json post /api/v1/workspaces/{workspaceId}/webhooks","href":"/api-reference/webhooks/create-webhook"},{"title":"Get webhook","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Get webhook","openapi":"/openapi/openapi.json get /api/v1/workspaces/{workspaceId}/webhooks/{webhookId}","href":"/api-reference/webhooks/get-webhook"},{"title":"Update or pause webhook","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Update or pause webhook","openapi":"/openapi/openapi.json patch /api/v1/workspaces/{workspaceId}/webhooks/{webhookId}","href":"/api-reference/webhooks/update-or-pause-webhook"},{"title":"Delete webhook","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Delete webhook","openapi":"/openapi/openapi.json delete /api/v1/workspaces/{workspaceId}/webhooks/{webhookId}","href":"/api-reference/webhooks/delete-webhook"},{"title":"List delivery history","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"List delivery history","openapi":"/openapi/openapi.json get /api/v1/workspaces/{workspaceId}/webhooks/{webhookId}/deliveries","href":"/api-reference/webhooks/list-delivery-history"},{"title":"Send synthetic test event","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Send synthetic test event","openapi":"/openapi/openapi.json post /api/v1/workspaces/{workspaceId}/webhooks/{webhookId}/test","href":"/api-reference/webhooks/send-synthetic-test-event"},{"title":"Retry failed delivery with original event and payload","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Retry failed delivery with original event and payload","openapi":"/openapi/openapi.json post /api/v1/workspaces/{workspaceId}/webhooks/{webhookId}/deliveries/{deliveryId}/retry","href":"/api-reference/webhooks/retry-failed-delivery-with-original-event-and-payload"},{"title":"Rotate signing secret","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Rotate signing secret","openapi":"/openapi/openapi.json post /api/v1/workspaces/{workspaceId}/webhooks/{webhookId}/rotate-secret","href":"/api-reference/webhooks/rotate-signing-secret"}]},{"group":"AI agent","pages":[{"title":"List agent conversations","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"List agent conversations","openapi":"/openapi/openapi.json get /api/v1/mailboxes/{mailboxId}/agent-conversations","href":"/api-reference/ai-agent/list-agent-conversations"},{"title":"Create agent conversation","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Create agent conversation","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/agent-conversations","href":"/api-reference/ai-agent/create-agent-conversation"},{"title":"Rename agent conversation","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Rename agent conversation","openapi":"/openapi/openapi.json patch /api/v1/mailboxes/{mailboxId}/agent-conversations/{conversationId}","href":"/api-reference/ai-agent/rename-agent-conversation"},{"title":"Delete agent conversation","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Delete agent conversation","openapi":"/openapi/openapi.json delete /api/v1/mailboxes/{mailboxId}/agent-conversations/{conversationId}","href":"/api-reference/ai-agent/delete-agent-conversation"},{"title":"List agent messages","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"List agent messages","openapi":"/openapi/openapi.json get /api/v1/mailboxes/{mailboxId}/agent-conversations/{conversationId}/messages","href":"/api-reference/ai-agent/list-agent-messages"},{"title":"Chat with mailbox agent","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Chat with mailbox agent","openapi":"/openapi/openapi.json post /api/agent/mailbox","href":"/api-reference/ai-agent/chat-with-mailbox-agent"}]},{"group":"Task triage","pages":[{"title":"List task triagers","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"List task triagers","openapi":"/openapi/openapi.json get /api/v1/mailboxes/{mailboxId}/task-triagers","href":"/api-reference/task-triage/list-task-triagers"},{"title":"Create task triager","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Create task triager","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/task-triagers","href":"/api-reference/task-triage/create-task-triager"},{"title":"List recent triager runs","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"List recent triager runs","openapi":"/openapi/openapi.json get /api/v1/mailboxes/{mailboxId}/task-triager-runs/recent","href":"/api-reference/task-triage/list-recent-triager-runs"},{"title":"Update task triager","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Update task triager","openapi":"/openapi/openapi.json put /api/v1/mailboxes/{mailboxId}/task-triagers/{triagerId}","href":"/api-reference/task-triage/update-task-triager"},{"title":"Delete task triager","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Delete task triager","openapi":"/openapi/openapi.json delete /api/v1/mailboxes/{mailboxId}/task-triagers/{triagerId}","href":"/api-reference/task-triage/delete-task-triager"},{"title":"Set default task triager","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Set default task triager","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/task-triagers/{triagerId}/default","href":"/api-reference/task-triage/set-default-task-triager"},{"title":"Get or create triager agent conversation","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Get or create triager agent conversation","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/task-triagers/{triagerId}/agent-conversation","href":"/api-reference/task-triage/get-or-create-triager-agent-conversation"}]},{"group":"Public","pages":[{"title":"Get API health status","deprecated":null,"version":null,"tag":"Public","sidebarTitle":"Get API health status","openapi":"/openapi/openapi.json get /api/status","href":"/api-reference/public/get-api-health-status"},{"title":"Get public app config","deprecated":null,"version":null,"tag":"Public","sidebarTitle":"Get public app config","openapi":"/openapi/openapi.json get /api/v1/config","href":"/api-reference/public/get-public-app-config"}]},{"group":"Usage","pages":[{"title":"Get API credit usage","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Get API credit usage","openapi":"/openapi/openapi.json get /api/v1/workspaces/{workspaceId}/usage/credits","href":"/api-reference/usage/get-api-credit-usage"},{"title":"Get email usage","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Get email usage","openapi":"/openapi/openapi.json get /api/v1/workspaces/{workspaceId}/usage/email","href":"/api-reference/usage/get-email-usage"}]},{"group":"Workspaces","pages":[{"title":"List workspaces","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"List workspaces","openapi":"/openapi/openapi.json get /api/v1/workspaces","href":"/api-reference/workspaces/list-workspaces"},{"title":"Get workspace","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Get workspace","openapi":"/openapi/openapi.json get /api/v1/workspaces/{workspaceId}","href":"/api-reference/workspaces/get-workspace"},{"title":"Update workspace","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Update workspace","openapi":"/openapi/openapi.json put /api/v1/workspaces/{workspaceId}","href":"/api-reference/workspaces/update-workspace"},{"title":"Get workspace storage","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Get workspace storage","openapi":"/openapi/openapi.json get /api/v1/workspaces/{workspaceId}/storage","href":"/api-reference/workspaces/get-workspace-storage"},{"title":"List workspace members","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"List workspace members","openapi":"/openapi/openapi.json get /api/v1/workspaces/{workspaceId}/members","href":"/api-reference/workspaces/list-workspace-members"},{"title":"Update member role","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Update member role","openapi":"/openapi/openapi.json put /api/v1/workspaces/{workspaceId}/members/{memberId}","href":"/api-reference/workspaces/update-member-role"},{"title":"Remove member","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Remove member","openapi":"/openapi/openapi.json delete /api/v1/workspaces/{workspaceId}/members/{memberId}","href":"/api-reference/workspaces/remove-member"},{"title":"Invite member","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Invite member","openapi":"/openapi/openapi.json post /api/v1/workspaces/{workspaceId}/invites","href":"/api-reference/workspaces/invite-member"},{"title":"Resend invite","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Resend invite","openapi":"/openapi/openapi.json post /api/v1/workspaces/{workspaceId}/invites/{inviteId}/resend","href":"/api-reference/workspaces/resend-invite"}]},{"group":"Domains","pages":[{"title":"List email domains","deprecated":null,"version":null,"tag":"Developer+","sidebarTitle":"List email domains","openapi":"/openapi/openapi.json get /api/v1/workspaces/{workspaceId}/email-domains","href":"/api-reference/domains/list-email-domains"},{"title":"Add email domain","deprecated":null,"version":null,"tag":"Developer+","sidebarTitle":"Add email domain","openapi":"/openapi/openapi.json post /api/v1/workspaces/{workspaceId}/email-domains","href":"/api-reference/domains/add-email-domain"},{"title":"Delete email domain","deprecated":null,"version":null,"tag":"Developer+","sidebarTitle":"Delete email domain","openapi":"/openapi/openapi.json delete /api/v1/workspaces/{workspaceId}/email-domains/{domainId}","href":"/api-reference/domains/delete-email-domain"},{"title":"Verify email domain","deprecated":null,"version":null,"tag":"Developer+","sidebarTitle":"Verify email domain","openapi":"/openapi/openapi.json post /api/v1/workspaces/{workspaceId}/email-domains/{domainId}/verify","href":"/api-reference/domains/verify-email-domain"}]},{"group":"Mailboxes","pages":[{"title":"List workspace mailboxes","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"List workspace mailboxes","openapi":"/openapi/openapi.json get /api/v1/workspaces/{workspaceId}/mailboxes","href":"/api-reference/mailboxes/list-workspace-mailboxes"},{"title":"List mailboxes","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"List mailboxes","openapi":"/openapi/openapi.json get /api/v1/mailboxes","href":"/api-reference/mailboxes/list-mailboxes"},{"title":"Create mailbox","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Create mailbox","openapi":"/openapi/openapi.json post /api/v1/mailboxes","href":"/api-reference/mailboxes/create-mailbox"},{"title":"Get mailbox","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Get mailbox","openapi":"/openapi/openapi.json get /api/v1/mailboxes/{mailboxId}","href":"/api-reference/mailboxes/get-mailbox"},{"title":"Update mailbox settings","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Update mailbox settings","openapi":"/openapi/openapi.json put /api/v1/mailboxes/{mailboxId}","href":"/api-reference/mailboxes/update-mailbox-settings"},{"title":"Get mailbox storage","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Get mailbox storage","openapi":"/openapi/openapi.json get /api/v1/mailboxes/{mailboxId}/storage","href":"/api-reference/mailboxes/get-mailbox-storage"}]},{"group":"Emails","pages":[{"title":"List emails","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"List emails","openapi":"/openapi/openapi.json get /api/v1/mailboxes/{mailboxId}/emails","href":"/api-reference/emails/list-emails"},{"title":"Send email","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Send email","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/emails","href":"/api-reference/emails/send-email"},{"title":"Get email","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Get email","openapi":"/openapi/openapi.json get /api/v1/mailboxes/{mailboxId}/emails/{emailId}","href":"/api-reference/emails/get-email"},{"title":"Update email","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Update email","openapi":"/openapi/openapi.json put /api/v1/mailboxes/{mailboxId}/emails/{emailId}","href":"/api-reference/emails/update-email"},{"title":"Delete email","description":"**Plans:** `Free` · `Developer` · `Enterprise`\n\nTrashes an email by default. Pass `permanent=true` to hard-delete (also used for messages already in trash). Returns **204** with an empty body.\n\n**API credits:** 2 (write).","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Delete email","openapi":"/openapi/openapi.json delete /api/v1/mailboxes/{mailboxId}/emails/{emailId}","href":"/api-reference/emails/delete-email"},{"title":"Get safe email and thread context","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Get safe email and thread context","openapi":"/openapi/openapi.json get /api/v1/mailboxes/{mailboxId}/emails/{emailId}/context","href":"/api-reference/emails/get-safe-email-and-thread-context"},{"title":"Bulk delete emails","description":"**Plans:** `Free` · `Developer` · `Enterprise`\n\nDeletes or trashes multiple emails by id. With `permanent: true`, hard-deletes; otherwise moves to trash (scheduled drafts are cancelled).\n\n**API credits:** 2 (write).","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Bulk delete emails","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/emails/bulk-delete","href":"/api-reference/emails/bulk-delete-emails"},{"title":"Bulk mark emails read","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Bulk mark emails read","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/emails/bulk-read","href":"/api-reference/emails/bulk-mark-emails-read"},{"title":"Bulk move emails","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Bulk move emails","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/emails/bulk-move","href":"/api-reference/emails/bulk-move-emails"},{"title":"Move email","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Move email","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/emails/{emailId}/move","href":"/api-reference/emails/move-email"},{"title":"Reply to email","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Reply to email","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/emails/{emailId}/reply","href":"/api-reference/emails/reply-to-email"},{"title":"Forward email","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Forward email","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/emails/{emailId}/forward","href":"/api-reference/emails/forward-email"},{"title":"Download attachment","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Download attachment","openapi":"/openapi/openapi.json get /api/v1/mailboxes/{mailboxId}/emails/{emailId}/attachments/{attachmentId}","href":"/api-reference/emails/download-attachment"},{"title":"Save draft","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Save draft","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/drafts","href":"/api-reference/emails/save-draft"},{"title":"Regenerate draft with AI","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Regenerate draft with AI","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/drafts/regenerate","href":"/api-reference/emails/regenerate-draft-with-ai"},{"title":"Schedule send","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Schedule send","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/scheduled-sends","href":"/api-reference/emails/schedule-send"},{"title":"Empty trash","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Empty trash","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/trash/empty","href":"/api-reference/emails/empty-trash"},{"title":"Get thread","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Get thread","openapi":"/openapi/openapi.json get /api/v1/mailboxes/{mailboxId}/threads/{threadId}","href":"/api-reference/emails/get-thread"},{"title":"Mark thread read","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Mark thread read","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/threads/{threadId}/read","href":"/api-reference/emails/mark-thread-read"},{"title":"List folders","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"List folders","openapi":"/openapi/openapi.json get /api/v1/mailboxes/{mailboxId}/folders","href":"/api-reference/emails/list-folders"},{"title":"Create folder","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Create folder","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/folders","href":"/api-reference/emails/create-folder"},{"title":"Update folder","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Update folder","openapi":"/openapi/openapi.json put /api/v1/mailboxes/{mailboxId}/folders/{folderId}","href":"/api-reference/emails/update-folder"},{"title":"Delete folder","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Delete folder","openapi":"/openapi/openapi.json delete /api/v1/mailboxes/{mailboxId}/folders/{folderId}","href":"/api-reference/emails/delete-folder"},{"title":"Search emails","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Search emails","openapi":"/openapi/openapi.json get /api/v1/mailboxes/{mailboxId}/search","href":"/api-reference/emails/search-emails"},{"title":"List custom labels","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"List custom labels","openapi":"/openapi/openapi.json get /api/v1/mailboxes/{mailboxId}/custom-labels","href":"/api-reference/emails/list-custom-labels"},{"title":"Create custom label","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Create custom label","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/custom-labels","href":"/api-reference/emails/create-custom-label"},{"title":"Update custom label","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Update custom label","openapi":"/openapi/openapi.json put /api/v1/mailboxes/{mailboxId}/custom-labels/{labelId}","href":"/api-reference/emails/update-custom-label"},{"title":"Delete custom label","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Delete custom label","openapi":"/openapi/openapi.json delete /api/v1/mailboxes/{mailboxId}/custom-labels/{labelId}","href":"/api-reference/emails/delete-custom-label"}]},{"group":"AI agent","pages":[{"title":"List agent conversations","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"List agent conversations","openapi":"/openapi/openapi.json get /api/v1/mailboxes/{mailboxId}/agent-conversations","href":"/api-reference/ai-agent/list-agent-conversations"},{"title":"Create agent conversation","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Create agent conversation","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/agent-conversations","href":"/api-reference/ai-agent/create-agent-conversation"},{"title":"Delete agent conversation","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Delete agent conversation","openapi":"/openapi/openapi.json delete /api/v1/mailboxes/{mailboxId}/agent-conversations/{conversationId}","href":"/api-reference/ai-agent/delete-agent-conversation"},{"title":"Rename agent conversation","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Rename agent conversation","openapi":"/openapi/openapi.json patch /api/v1/mailboxes/{mailboxId}/agent-conversations/{conversationId}","href":"/api-reference/ai-agent/rename-agent-conversation"},{"title":"List agent messages","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"List agent messages","openapi":"/openapi/openapi.json get /api/v1/mailboxes/{mailboxId}/agent-conversations/{conversationId}/messages","href":"/api-reference/ai-agent/list-agent-messages"},{"title":"Chat with mailbox agent","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Chat with mailbox agent","openapi":"/openapi/openapi.json post /api/agent/mailbox","href":"/api-reference/ai-agent/chat-with-mailbox-agent"}]},{"group":"Task triage","pages":[{"title":"List task triagers","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"List task triagers","openapi":"/openapi/openapi.json get /api/v1/mailboxes/{mailboxId}/task-triagers","href":"/api-reference/task-triage/list-task-triagers"},{"title":"Create task triager","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Create task triager","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/task-triagers","href":"/api-reference/task-triage/create-task-triager"},{"title":"List recent triager runs","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"List recent triager runs","openapi":"/openapi/openapi.json get /api/v1/mailboxes/{mailboxId}/task-triager-runs/recent","href":"/api-reference/task-triage/list-recent-triager-runs"},{"title":"Update task triager","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Update task triager","openapi":"/openapi/openapi.json put /api/v1/mailboxes/{mailboxId}/task-triagers/{triagerId}","href":"/api-reference/task-triage/update-task-triager"},{"title":"Delete task triager","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Delete task triager","openapi":"/openapi/openapi.json delete /api/v1/mailboxes/{mailboxId}/task-triagers/{triagerId}","href":"/api-reference/task-triage/delete-task-triager"},{"title":"Set default task triager","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Set default task triager","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/task-triagers/{triagerId}/default","href":"/api-reference/task-triage/set-default-task-triager"},{"title":"Get or create triager agent conversation","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Get or create triager agent conversation","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/task-triagers/{triagerId}/agent-conversation","href":"/api-reference/task-triage/get-or-create-triager-agent-conversation"}]},{"group":"RAG","pages":[{"title":"List RAG documents","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"List RAG documents","openapi":"/openapi/openapi.json get /api/v1/rag/documents","href":"/api-reference/rag/list-rag-documents"},{"title":"Upload RAG document","deprecated":null,"version":null,"tag":"Developer+","sidebarTitle":"Upload RAG document","openapi":"/openapi/openapi.json post /api/v1/rag/documents","href":"/api-reference/rag/upload-rag-document"},{"title":"Get RAG document","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Get RAG document","openapi":"/openapi/openapi.json get /api/v1/rag/documents/{id}","href":"/api-reference/rag/get-rag-document"},{"title":"Delete RAG document","deprecated":null,"version":null,"tag":"Developer+","sidebarTitle":"Delete RAG document","openapi":"/openapi/openapi.json delete /api/v1/rag/documents/{id}","href":"/api-reference/rag/delete-rag-document"},{"title":"Download RAG document","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Download RAG document","openapi":"/openapi/openapi.json get /api/v1/rag/documents/{id}/download","href":"/api-reference/rag/download-rag-document"},{"title":"Verify RAG document","deprecated":null,"version":null,"tag":"Developer+","sidebarTitle":"Verify RAG document","openapi":"/openapi/openapi.json post /api/v1/rag/documents/{id}/verify","href":"/api-reference/rag/verify-rag-document"},{"title":"Get RAG credentials status","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Get RAG credentials status","openapi":"/openapi/openapi.json get /api/v1/rag/credentials","href":"/api-reference/rag/get-rag-credentials-status"},{"title":"Prepare RAG credentials","deprecated":null,"version":null,"tag":"Developer+","sidebarTitle":"Prepare RAG credentials","openapi":"/openapi/openapi.json post /api/v1/rag/credentials/prepare","href":"/api-reference/rag/prepare-rag-credentials"},{"title":"Complete RAG credentials","deprecated":null,"version":null,"tag":"Developer+","sidebarTitle":"Complete RAG credentials","openapi":"/openapi/openapi.json post /api/v1/rag/credentials/complete","href":"/api-reference/rag/complete-rag-credentials"},{"title":"Verify RAG credentials","deprecated":null,"version":null,"tag":"Developer+","sidebarTitle":"Verify RAG credentials","openapi":"/openapi/openapi.json post /api/v1/rag/credentials/verify","href":"/api-reference/rag/verify-rag-credentials"},{"title":"Recall from RAG","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Recall from RAG","openapi":"/openapi/openapi.json post /api/v1/rag/recall","href":"/api-reference/rag/recall-from-rag"}]},{"group":"Integrations","pages":[{"title":"Get Telegram link","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Get Telegram link","openapi":"/openapi/openapi.json get /api/v1/mailboxes/{mailboxId}/telegram","href":"/api-reference/integrations/get-telegram-link"},{"title":"Unlink Telegram","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Unlink Telegram","openapi":"/openapi/openapi.json delete /api/v1/mailboxes/{mailboxId}/telegram","href":"/api-reference/integrations/unlink-telegram"},{"title":"Link Telegram","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Link Telegram","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/telegram/link","href":"/api-reference/integrations/link-telegram"},{"title":"Get push subscription","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Get push subscription","openapi":"/openapi/openapi.json get /api/v1/mailboxes/{mailboxId}/push","href":"/api-reference/integrations/get-push-subscription"},{"title":"Subscribe push","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Subscribe push","openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/push/subscribe","href":"/api-reference/integrations/subscribe-push"},{"title":"Unsubscribe push","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Unsubscribe push","openapi":"/openapi/openapi.json delete /api/v1/mailboxes/{mailboxId}/push/subscribe","href":"/api-reference/integrations/unsubscribe-push"},{"title":"List Composio toolkits","deprecated":null,"version":null,"tag":"Developer+","sidebarTitle":"List Composio toolkits","openapi":"/openapi/openapi.json get /api/v1/integrations/composio/toolkits","href":"/api-reference/integrations/list-composio-toolkits"},{"title":"Connect Composio toolkit","deprecated":null,"version":null,"tag":"Developer+","sidebarTitle":"Connect Composio toolkit","openapi":"/openapi/openapi.json post /api/v1/integrations/composio/toolkits/{slug}/connect","href":"/api-reference/integrations/connect-composio-toolkit"},{"title":"Disconnect Composio toolkit","deprecated":null,"version":null,"tag":"Developer+","sidebarTitle":"Disconnect Composio toolkit","openapi":"/openapi/openapi.json delete /api/v1/integrations/composio/toolkits/{slug}/connection","href":"/api-reference/integrations/disconnect-composio-toolkit"},{"title":"List Composio connections","deprecated":null,"version":null,"tag":"Developer+","sidebarTitle":"List Composio connections","openapi":"/openapi/openapi.json get /api/v1/integrations/composio/connections","href":"/api-reference/integrations/list-composio-connections"},{"title":"Sync Composio connections","deprecated":null,"version":null,"tag":"Developer+","sidebarTitle":"Sync Composio connections","openapi":"/openapi/openapi.json post /api/v1/integrations/composio/connections/sync","href":"/api-reference/integrations/sync-composio-connections"},{"title":"Search Composio tools","deprecated":null,"version":null,"tag":"Developer+","sidebarTitle":"Search Composio tools","openapi":"/openapi/openapi.json get /api/v1/integrations/composio/tools","href":"/api-reference/integrations/search-composio-tools"},{"title":"Get Composio tool schema","deprecated":null,"version":null,"tag":"Developer+","sidebarTitle":"Get Composio tool schema","openapi":"/openapi/openapi.json get /api/v1/integrations/composio/tools/{slug}","href":"/api-reference/integrations/get-composio-tool-schema"},{"title":"Execute Composio tool","deprecated":null,"version":null,"tag":"Developer+","sidebarTitle":"Execute Composio tool","openapi":"/openapi/openapi.json post /api/v1/integrations/composio/tools/execute","href":"/api-reference/integrations/execute-composio-tool"},{"title":"Get Composio calendar account","deprecated":null,"version":null,"tag":"Developer+","sidebarTitle":"Get Composio calendar account","openapi":"/openapi/openapi.json get /api/v1/integrations/composio/calendar/account","href":"/api-reference/integrations/get-composio-calendar-account"}]},{"group":"Affiliate","pages":[{"title":"Get affiliate profile","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Get affiliate profile","openapi":"/openapi/openapi.json get /api/v1/affiliate/me","href":"/api-reference/affiliate/get-affiliate-profile"},{"title":"Update affiliate profile","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Update affiliate profile","openapi":"/openapi/openapi.json patch /api/v1/affiliate/me","href":"/api-reference/affiliate/update-affiliate-profile"},{"title":"Sign up as affiliate","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Sign up as affiliate","openapi":"/openapi/openapi.json post /api/v1/affiliate/signup","href":"/api-reference/affiliate/sign-up-as-affiliate"},{"title":"Get affiliate analytics","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Get affiliate analytics","openapi":"/openapi/openapi.json get /api/v1/affiliate/analytics","href":"/api-reference/affiliate/get-affiliate-analytics"},{"title":"List affiliate payouts","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"List affiliate payouts","openapi":"/openapi/openapi.json get /api/v1/affiliate/payouts","href":"/api-reference/affiliate/list-affiliate-payouts"},{"title":"List affiliate commissions","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"List affiliate commissions","openapi":"/openapi/openapi.json get /api/v1/affiliate/commissions","href":"/api-reference/affiliate/list-affiliate-commissions"},{"title":"Track affiliate click","deprecated":null,"version":null,"tag":"Public","sidebarTitle":"Track affiliate click","openapi":"/openapi/openapi.json get /api/affiliate/track","href":"/api-reference/affiliate/track-affiliate-click"}]},{"group":"Webhooks","pages":[{"title":"List webhooks","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"List webhooks","openapi":"/openapi/openapi.json get /api/v1/workspaces/{workspaceId}/webhooks","href":"/api-reference/webhooks/list-webhooks"},{"title":"Create webhook","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Create webhook","openapi":"/openapi/openapi.json post /api/v1/workspaces/{workspaceId}/webhooks","href":"/api-reference/webhooks/create-webhook"},{"title":"Get webhook","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Get webhook","openapi":"/openapi/openapi.json get /api/v1/workspaces/{workspaceId}/webhooks/{webhookId}","href":"/api-reference/webhooks/get-webhook"},{"title":"Delete webhook","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Delete webhook","openapi":"/openapi/openapi.json delete /api/v1/workspaces/{workspaceId}/webhooks/{webhookId}","href":"/api-reference/webhooks/delete-webhook"},{"title":"Update or pause webhook","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Update or pause webhook","openapi":"/openapi/openapi.json patch /api/v1/workspaces/{workspaceId}/webhooks/{webhookId}","href":"/api-reference/webhooks/update-or-pause-webhook"},{"title":"List delivery history","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"List delivery history","openapi":"/openapi/openapi.json get /api/v1/workspaces/{workspaceId}/webhooks/{webhookId}/deliveries","href":"/api-reference/webhooks/list-delivery-history"},{"title":"Send synthetic test event","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Send synthetic test event","openapi":"/openapi/openapi.json post /api/v1/workspaces/{workspaceId}/webhooks/{webhookId}/test","href":"/api-reference/webhooks/send-synthetic-test-event"},{"title":"Retry failed delivery with original event and payload","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Retry failed delivery with original event and payload","openapi":"/openapi/openapi.json post /api/v1/workspaces/{workspaceId}/webhooks/{webhookId}/deliveries/{deliveryId}/retry","href":"/api-reference/webhooks/retry-failed-delivery-with-original-event-and-payload"},{"title":"Rotate signing secret","deprecated":null,"version":null,"tag":"All plans","sidebarTitle":"Rotate signing secret","openapi":"/openapi/openapi.json post /api/v1/workspaces/{workspaceId}/webhooks/{webhookId}/rotate-secret","href":"/api-reference/webhooks/rotate-signing-secret"}]},{"group":"API Reference","pages":[{"title":"List saved and blocked plus aliases","deprecated":null,"version":null,"openapi":"/openapi/openapi.json get /api/v1/mailboxes/{mailboxId}/aliases","href":"/api-reference/list-saved-and-blocked-plus-aliases"},{"title":"Save a plus alias shortcut","deprecated":null,"version":null,"openapi":"/openapi/openapi.json post /api/v1/mailboxes/{mailboxId}/aliases","href":"/api-reference/save-a-plus-alias-shortcut"},{"title":"Update, block, or unblock a plus alias","deprecated":null,"version":null,"openapi":"/openapi/openapi.json put /api/v1/mailboxes/{mailboxId}/aliases/{tag}","href":"/api-reference/update-block-or-unblock-a-plus-alias"},{"title":"Remove a saved alias shortcut","deprecated":null,"version":null,"openapi":"/openapi/openapi.json delete /api/v1/mailboxes/{mailboxId}/aliases/{tag}","href":"/api-reference/remove-a-saved-alias-shortcut"}]}]}]},"basePath":"","title":"Get safe email and thread context - Mermail","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}