Qubrics API key. Use a root API key for Management API routes, or a mailbox credential for Mailbox API routes. Obtain keys from the dashboard under API Keys.
Scopes
mailbox.read
Read mailbox contents (folders, messages)
Query Parameters
cursor
string
Pagination cursor — the next_cursor from the previous response.
limit
integer
Maximum results (default 50, max 100).
Required range: 1 <= x <= 100
folder_id
string
Filter to messages in this folder ID.
thread_id
string
Filter to messages in this thread ID.
q
string
Full-text search query across message fields.
from
string
Filter by sender email address or display name.
to
string
Filter by To recipient email address or display name.
cc
string
Filter by CC recipient email address or display name.
bcc
string
Filter by BCC recipient email address or display name.
subject
string
Filter by subject text.
body
string
Filter by message body text.
header_name
string
Header name to match with header_value.
header_value
string
Header value to match with header_name.
min_size_bytes
integer
Minimum message size in bytes.
Required range: x >= 0
max_size_bytes
integer
Maximum message size in bytes.
Required range: x >= 0
keyword
string
Require this message keyword, such as $seen.
not_keyword
string
Exclude messages with this keyword.
after
string
Filter to messages after this ISO 8601 timestamp.
before
string
Filter to messages before this ISO 8601 timestamp.
has_attachment
boolean
When true, only return messages with attachments.
is_unread
boolean
When true, only return unread messages.
sort_by
enum<string>
Message field to sort by.
Available options:
received_at,
sent_at,
subject,
from,
to,
size_bytes
sort_direction
enum<string>
Sort direction.
Available options:
asc,
desc
mailbox_id
string
Mailbox public ID to target when the credential grants access to more than one mailbox. Omit when the credential is scoped to exactly one mailbox.
Response
Message list
meta
object
required
Hide child attributes
meta.request_id
string
required
meta.sync_state
string
ok
enum<boolean>
required
Available options:
true
data
object[]
required
Hide child attributes
data.bcc
object[]
required
Hide child attributes
data.bcc.email
string<email>
required
Example:
"agent@example.com"
data.bcc.name
string | null
required
Example:
"Support"
data.cc
object[]
required
Hide child attributes
data.cc.email
string<email>
required
Example:
"agent@example.com"
data.cc.name
string | null
required
Example:
"Support"
data.flags
object
required
Hide child attributes
data.flags.answered
boolean
required
data.flags.draft
boolean
required
data.flags.flagged
boolean
required
data.flags.seen
boolean
required
data.folder_ids
string[]
required
data.from
object | null
required
Hide child attributes
data.from.email
string<email>
required
Example:
"agent@example.com"
data.from.name
string | null
required
Example:
"Support"
data.has_attachments
boolean
required
data.id
string
required
Message ID
data.keywords
string[]
required
Active message keywords, including system flags and custom labels.
Example:
["$seen", "$flagged", "agent_triaged"]
data.preview
string | null
required
data.received_at
string | null
required
data.sent_at
string | null
required
data.size_bytes
integer | null
required
data.subject
string | null
required
data.thread_id
string | null
required
data.to
object[]
required
Hide child attributes
data.to.email
string<email>
required
Example:
"agent@example.com"
data.to.name
string | null
required
Example:
"Support"
data.attachments
object[]
Attachment metadata for this message. Each item includes a short-lived download_url; if it expires, fetch message metadata again.
Hide child attributes
data.attachments.content_id
string | null
required
Content ID for inline attachments, when present.
data.attachments.content_type
string
required
Example:
"application/pdf"
data.attachments.disposition
string | null
required
Example:
"attachment"
data.attachments.filename
string | null
required
Example:
"invoice.pdf"
data.attachments.id
string
required
Attachment blob ID.
data.attachments.size_bytes
integer | null
required
Example:
12345
data.attachments.download_url
string
Short-lived URL for this exact attachment. Fetch it promptly; if it expires, call the message or attachment metadata endpoint again to receive a fresh URL.
{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/docs.json","name":"Qubrics","description":"The intelligent email layer","colors":{"primary":"#6a75f1","light":"#5a84e9","dark":"#004aad"},"logo":{"light":"https://mintcdn.com/sendmux/9EML6-L2IAWgIXVX/images/logo-light.svg?fit=max\u0026auto=format\u0026n=9EML6-L2IAWgIXVX\u0026q=85\u0026s=0d301b6a4a28e21cf585335973584967","dark":"https://mintcdn.com/sendmux/9EML6-L2IAWgIXVX/images/logo-dark.svg?fit=max\u0026auto=format\u0026n=9EML6-L2IAWgIXVX\u0026q=85\u0026s=612f5f9e57f97fd13812a619d185a2f9","href":"https://qubrics.com/docs"},"favicon":"https://mintcdn.com/sendmux/neuAiuAvPYRu89eG/images/favicon.svg?fit=max\u0026auto=format\u0026n=neuAiuAvPYRu89eG\u0026q=85\u0026s=557baee52eeabff3955db74427754525","api":{"params":{"expanded":"all"},"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","python","javascript","go"],"autogenerate":true}},"appearance":{"default":"system"},"navbar":{"links":[{"href":"/changelog","label":"Changelog"},{"href":"mailto:contact@qubrics.com","label":"Support"}],"primary":{"type":"button","label":"App","href":"https://app.qubrics.com"}},"footer":{"socials":{"x":"https://x.com/sendmux","github":"https://github.com/qubrics"}},"seo":{"metatags":{"canonical":"https://qubrics.com/docs"}},"fonts":{"family":"Lato","weight":400},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"App","href":"https://app.qubrics.com"},{"anchor":"Website","href":"https://qubrics.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"sendmux","hasAudioNarration":false,"actualSubdomain":"sendmux","customDomains":["qubrics.com"],"gitSource":{"type":"github","owner":"qubrics","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":true,"issues":true,"agentFeedback":true},"entitlements":{},"buildId":"6b002092cf93c63408f0644f","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"Guides","count":79},{"language":"default","tag":"Management API","count":58},{"language":"default","tag":"Mailbox API","count":55},{"language":"default","tag":"AI integrations","count":32},{"language":"default","tag":"MCP","count":23},{"language":"default","tag":"Client setup","count":23},{"language":"default","tag":"Developer tools","count":20},{"language":"default","tag":"Sending accounts","count":18},{"language":"default","tag":"Mailboxes","count":15},{"language":"default","tag":"Messages","count":14}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","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}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":":root{font-size:103%}.antialiased{-webkit-font-smoothing:auto!important;-moz-osx-font-smoothing:auto!important}.h1,.h2,.h3,.h4,.h5,.h6,h1,h2,h3,h4,h5,h6,.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{letter-spacing:var(--tracking-tight)!important}body,.prose,.prose p,.prose li,.prose td,.prose th,.prose blockquote{letter-spacing:0.00625rem!important}.eyebrow.h-5{text-transform:uppercase;letter-spacing:0.063em!important}h3.sidebar-title,#sidebar-title{display:flex;align-items:center;height:1.75rem;color:oklch(0.345 0.006 264 / 60%);text-transform:uppercase;font-size:0.7rem;font-weight:400;letter-spacing:0.044rem!important}.dark h3.sidebar-title,.dark #sidebar-title{color:oklch(0.985 0.001 106.423 / 60%)}"}]}
{"page":{"pagePath":"api/mailbox-api/list-mailbox-messages","slug":"/api/mailbox-api/list-mailbox-messages","pageMetadata":{"title":"List mailbox messages","description":"Returns a cursor-paginated list of messages for the authenticated mailbox. Requires Mailbox API access.","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/messages","href":"/api/mailbox-api/list-mailbox-messages","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Returns a cursor-paginated list of messages for the authenticated mailbox. Requires Mailbox API access.\"\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":"List mailbox messages","description":"Returns a cursor-paginated list of messages for the authenticated mailbox. Requires Mailbox API access.","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/messages","href":"/api/mailbox-api/list-mailbox-messages","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Returns a cursor-paginated list of messages for the authenticated mailbox. Requires Mailbox API access.","operationId":"mailboxListMessages","parameters":["72626bf5-b3ca-42a3-b976-58c8c19a0385","c3016695-1cc2-487c-be9f-725f9d723bf4","2dbc88f9-3b48-4b36-9346-02cd1362eab9","96b56f0a-b3a1-4adc-8839-c708cf0b4754","ec35dd9b-deb1-4d34-bf52-3923d7bbbee5","f9661cee-0c64-41b1-b7b0-1fb239bdf88e","a8e2eb0d-b0c2-4b7a-b3c8-52d0aa069b00","b7b60cba-5b92-42b6-8d04-beec76180b39","856baf83-0b75-4c53-a8b5-def8bb03cdb0","4b03bcff-ed05-41b8-a9e2-06a1f27a9a32","6cd73a9b-1a05-4ce4-8199-4094d3780300","3a2c2413-f2ad-406e-884d-72616e61a08a","95930135-5426-4c8b-bb3f-d34225ea1d43","413bf111-75ea-4cde-91bd-0f2554384d22","419ef4c9-a032-4977-8c93-37190a8aebc3","5740ea64-2b68-4480-a73d-78ac7357e2a6","3db2d72c-b22b-479f-b99e-6ef126272c34","72356db7-2cf0-443b-b79c-be4d8f7fcc3d","5a4d7624-10bd-4b84-834a-d1167050e1ec","76616155-7d36-47f2-8e6f-e8079f94b9e1","038fa32b-e4b7-496d-ba42-5afbc1ea499b","17b6d6b9-08cc-42f4-84da-e423f3386aa4","eaf4a669-1ee2-4a4a-97eb-bf9fee656817","fc6eec8f-e119-4f46-b8eb-924856c053a0"],"responses":{"200":"3af31b08-761a-4907-abb0-6d1c39c98c5f","400":"c69be1ac-ccbd-4c21-836f-af9f4d72632c","401":"681bf130-e823-428a-8e19-5c3eac2a4740","403":"61dd52a4-3ba5-4db3-b1f0-a416e7502705"},"security":["dfd2d9ef-993d-4b80-a0a2-10f9340146d4","545e5ff5-b589-49ed-aaf1-f05dbb2fde15"],"summary":"List mailbox messages","tags":["Mailbox API"],"method":"get","type":"path","servers":["47cfcb91-0c9c-47bb-8bd6-fe2f163124de"],"path":"/mailbox/messages","baseUrlOptions":["https://app.qubrics.com/api/v1"],"title":"List mailbox messages","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","go"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"72626bf5-b3ca-42a3-b976-58c8c19a0385":{"in":"query","name":"cursor","required":false,"schema":{"description":"Pagination cursor — the `next_cursor` from the previous response.","type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"}},"c3016695-1cc2-487c-be9f-725f9d723bf4":{"in":"query","name":"limit","required":false,"schema":{"description":"Maximum results (default 50, max 100).","maximum":100,"minimum":1,"type":"integer","isRequired":false,"uniqueKey":"","typeLabel":"integer"}},"2dbc88f9-3b48-4b36-9346-02cd1362eab9":{"in":"query","name":"folder_id","required":false,"schema":{"description":"Filter to messages in this folder ID.","type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"}},"96b56f0a-b3a1-4adc-8839-c708cf0b4754":{"in":"query","name":"thread_id","required":false,"schema":{"description":"Filter to messages in this thread ID.","type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"}},"ec35dd9b-deb1-4d34-bf52-3923d7bbbee5":{"in":"query","name":"q","required":false,"schema":{"description":"Full-text search query across message fields.","type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"}},"f9661cee-0c64-41b1-b7b0-1fb239bdf88e":{"in":"query","name":"from","required":false,"schema":{"description":"Filter by sender email address or display name.","type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"}},"a8e2eb0d-b0c2-4b7a-b3c8-52d0aa069b00":{"in":"query","name":"to","required":false,"schema":{"description":"Filter by To recipient email address or display name.","type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"}},"b7b60cba-5b92-42b6-8d04-beec76180b39":{"in":"query","name":"cc","required":false,"schema":{"description":"Filter by CC recipient email address or display name.","type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"}},"856baf83-0b75-4c53-a8b5-def8bb03cdb0":{"in":"query","name":"bcc","required":false,"schema":{"description":"Filter by BCC recipient email address or display name.","type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"}},"4b03bcff-ed05-41b8-a9e2-06a1f27a9a32":{"in":"query","name":"subject","required":false,"schema":{"description":"Filter by subject text.","type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"}},"6cd73a9b-1a05-4ce4-8199-4094d3780300":{"in":"query","name":"body","required":false,"schema":{"description":"Filter by message body text.","type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"}},"3a2c2413-f2ad-406e-884d-72616e61a08a":{"in":"query","name":"header_name","required":false,"schema":{"description":"Header name to match with `header_value`.","type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"}},"95930135-5426-4c8b-bb3f-d34225ea1d43":{"in":"query","name":"header_value","required":false,"schema":{"description":"Header value to match with `header_name`.","type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"}},"413bf111-75ea-4cde-91bd-0f2554384d22":{"in":"query","name":"min_size_bytes","required":false,"schema":{"description":"Minimum message size in bytes.","minimum":0,"type":"integer","isRequired":false,"uniqueKey":"","typeLabel":"integer"}},"419ef4c9-a032-4977-8c93-37190a8aebc3":{"in":"query","name":"max_size_bytes","required":false,"schema":{"description":"Maximum message size in bytes.","minimum":0,"type":"integer","isRequired":false,"uniqueKey":"","typeLabel":"integer"}},"5740ea64-2b68-4480-a73d-78ac7357e2a6":{"in":"query","name":"keyword","required":false,"schema":{"description":"Require this message keyword, such as `$seen`.","type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"}},"3db2d72c-b22b-479f-b99e-6ef126272c34":{"in":"query","name":"not_keyword","required":false,"schema":{"description":"Exclude messages with this keyword.","type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"}},"72356db7-2cf0-443b-b79c-be4d8f7fcc3d":{"in":"query","name":"after","required":false,"schema":{"description":"Filter to messages after this ISO 8601 timestamp.","type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"}},"5a4d7624-10bd-4b84-834a-d1167050e1ec":{"in":"query","name":"before","required":false,"schema":{"description":"Filter to messages before this ISO 8601 timestamp.","type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"}},"76616155-7d36-47f2-8e6f-e8079f94b9e1":{"in":"query","name":"has_attachment","required":false,"schema":{"description":"When true, only return messages with attachments.","type":"boolean","isRequired":false,"uniqueKey":"","typeLabel":"boolean"}},"038fa32b-e4b7-496d-ba42-5afbc1ea499b":{"in":"query","name":"is_unread","required":false,"schema":{"description":"When true, only return unread messages.","type":"boolean","isRequired":false,"uniqueKey":"","typeLabel":"boolean"}},"17b6d6b9-08cc-42f4-84da-e423f3386aa4":{"in":"query","name":"sort_by","required":false,"schema":{"description":"Message field to sort by.","enum":["received_at","sent_at","subject","from","to","size_bytes"],"type":"string","isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring>"}},"eaf4a669-1ee2-4a4a-97eb-bf9fee656817":{"in":"query","name":"sort_direction","required":false,"schema":{"description":"Sort direction.","enum":["asc","desc"],"type":"string","isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring>"}},"fc6eec8f-e119-4f46-b8eb-924856c053a0":{"description":"Mailbox public ID to target when the credential grants access to more than one mailbox. Omit when the credential is scoped to exactly one mailbox.","in":"query","name":"mailbox_id","required":false,"schema":{"type":"string","isRequired":false,"description":"Mailbox public ID to target when the credential grants access to more than one mailbox. Omit when the credential is scoped to exactly one mailbox.","uniqueKey":"","typeLabel":"string"}}},"responses":{"3af31b08-761a-4907-abb0-6d1c39c98c5f":{"content":{"application/json":{"schema":{"type":"object","required":["data","pagination","ok","meta"],"properties":{"meta":{"type":"object","required":["request_id"],"properties":{"request_id":{"type":"string","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string"},"sync_state":{"type":"string","uniqueKey":"meta.sync_state","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"meta","typeLabel":"object"},"ok":{"enum":[true],"type":"boolean","isRequired":true,"uniqueKey":"ok","typeLabel":"enum\u003cboolean>"},"data":{"items":{"additionalProperties":false,"properties":{"bcc":{"items":{"additionalProperties":false,"properties":{"email":{"example":"agent@example.com","format":"email","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].bcc.items.[INDEX].email","typeLabel":"string\u003cemail>"},"name":{"oneOf":[{"example":"Support","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].bcc.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"example":"Support","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].bcc.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].bcc.items.[INDEX].name","typeLabel":"string | null"}},"required":["email","name"],"type":"object","uniqueKey":"data.items.[INDEX].bcc.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"data.items.[INDEX].bcc","typeLabel":"object[]"},"cc":{"items":{"additionalProperties":false,"properties":{"email":{"example":"agent@example.com","format":"email","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].cc.items.[INDEX].email","typeLabel":"string\u003cemail>"},"name":{"oneOf":[{"example":"Support","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].cc.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"example":"Support","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].cc.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].cc.items.[INDEX].name","typeLabel":"string | null"}},"required":["email","name"],"type":"object","uniqueKey":"data.items.[INDEX].cc.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"data.items.[INDEX].cc","typeLabel":"object[]"},"flags":{"additionalProperties":false,"properties":{"answered":{"type":"boolean","isRequired":true,"uniqueKey":"data.items.[INDEX].flags.answered","typeLabel":"boolean"},"draft":{"type":"boolean","isRequired":true,"uniqueKey":"data.items.[INDEX].flags.draft","typeLabel":"boolean"},"flagged":{"type":"boolean","isRequired":true,"uniqueKey":"data.items.[INDEX].flags.flagged","typeLabel":"boolean"},"seen":{"type":"boolean","isRequired":true,"uniqueKey":"data.items.[INDEX].flags.seen","typeLabel":"boolean"}},"required":["seen","flagged","draft","answered"],"type":"object","isRequired":true,"uniqueKey":"data.items.[INDEX].flags","typeLabel":"object"},"folder_ids":{"items":{"type":"string","uniqueKey":"data.items.[INDEX].folder_ids.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"data.items.[INDEX].folder_ids","typeLabel":"string[]"},"from":{"oneOf":[{"type":"object","required":["email","name"],"properties":{"email":{"example":"agent@example.com","format":"email","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].from.oneOf.0.email","typeLabel":"string\u003cemail>"},"name":{"oneOf":[{"example":"Support","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].from.oneOf.0.name.oneOf.0","typeLabel":"string"},{"example":"Support","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].from.oneOf.0.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].from.oneOf.0.name","typeLabel":"string | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.items.[INDEX].from.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].from.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].from","typeLabel":"object | null"},"has_attachments":{"type":"boolean","isRequired":true,"uniqueKey":"data.items.[INDEX].has_attachments","typeLabel":"boolean"},"id":{"description":"Message ID","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].id","typeLabel":"string"},"keywords":{"description":"Active message keywords, including system flags and custom labels.","example":["$seen","$flagged","agent_triaged"],"items":{"type":"string","uniqueKey":"data.items.[INDEX].keywords.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"data.items.[INDEX].keywords","typeLabel":"string[]"},"preview":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].preview.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].preview.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].preview","typeLabel":"string | null"},"received_at":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].received_at.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].received_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].received_at","typeLabel":"string | null"},"sent_at":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].sent_at.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].sent_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].sent_at","typeLabel":"string | null"},"size_bytes":{"oneOf":[{"type":"integer","isRequired":true,"uniqueKey":"data.items.[INDEX].size_bytes.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].size_bytes.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].size_bytes","typeLabel":"integer | null"},"subject":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].subject.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].subject.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].subject","typeLabel":"string | null"},"thread_id":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].thread_id.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].thread_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].thread_id","typeLabel":"string | null"},"to":{"items":{"additionalProperties":false,"properties":{"email":{"example":"agent@example.com","format":"email","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].to.items.[INDEX].email","typeLabel":"string\u003cemail>"},"name":{"oneOf":[{"example":"Support","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].to.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"example":"Support","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].to.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].to.items.[INDEX].name","typeLabel":"string | null"}},"required":["email","name"],"type":"object","uniqueKey":"data.items.[INDEX].to.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"data.items.[INDEX].to","typeLabel":"object[]"},"attachments":{"description":"Attachment metadata for this message. Each item includes a short-lived `download_url`; if it expires, fetch message metadata again.","items":{"additionalProperties":false,"properties":{"content_id":{"oneOf":[{"description":"Content ID for inline attachments, when present.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].attachments.items.[INDEX].content_id.oneOf.0","typeLabel":"string"},{"description":"Content ID for inline attachments, when present.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].attachments.items.[INDEX].content_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].attachments.items.[INDEX].content_id","typeLabel":"string | null"},"content_type":{"example":"application/pdf","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].attachments.items.[INDEX].content_type","typeLabel":"string"},"disposition":{"oneOf":[{"example":"attachment","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].attachments.items.[INDEX].disposition.oneOf.0","typeLabel":"string"},{"example":"attachment","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].attachments.items.[INDEX].disposition.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].attachments.items.[INDEX].disposition","typeLabel":"string | null"},"filename":{"oneOf":[{"example":"invoice.pdf","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].attachments.items.[INDEX].filename.oneOf.0","typeLabel":"string"},{"example":"invoice.pdf","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].attachments.items.[INDEX].filename.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].attachments.items.[INDEX].filename","typeLabel":"string | null"},"id":{"description":"Attachment blob ID.","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].attachments.items.[INDEX].id","typeLabel":"string"},"size_bytes":{"oneOf":[{"example":12345,"type":"integer","isRequired":true,"uniqueKey":"data.items.[INDEX].attachments.items.[INDEX].size_bytes.oneOf.0","typeLabel":"integer"},{"example":12345,"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].attachments.items.[INDEX].size_bytes.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].attachments.items.[INDEX].size_bytes","typeLabel":"integer | null"},"download_url":{"description":"Short-lived URL for this exact attachment. Fetch it promptly; if it expires, call the message or attachment metadata endpoint again to receive a fresh URL.","example":"https://app.qubrics.com/api/v1/mailbox/messages/msg_123/attachment-downloads/attref_abc123?download_token=...","type":"string","uniqueKey":"data.items.[INDEX].attachments.items.[INDEX].download_url","typeLabel":"string"}},"required":["id","filename","content_type","size_bytes","disposition","content_id"],"type":"object","uniqueKey":"data.items.[INDEX].attachments.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"data.items.[INDEX].attachments","typeLabel":"object[]"}},"required":["id","thread_id","folder_ids","subject","preview","from","to","cc","bcc","received_at","sent_at","size_bytes","has_attachments","keywords","flags"],"type":"object","uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"data","typeLabel":"object[]"},"pagination":{"additionalProperties":false,"properties":{"has_more":{"type":"boolean","isRequired":true,"uniqueKey":"pagination.has_more","typeLabel":"boolean"},"next_cursor":{"type":"string","uniqueKey":"pagination.next_cursor","typeLabel":"string"}},"required":["has_more"],"type":"object","isRequired":true,"uniqueKey":"pagination","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"meta":{"request_id":"\u003cstring>","sync_state":"\u003cstring>"},"ok":true,"data":[{"bcc":[{"email":"agent@example.com","name":"Support"}],"cc":[{"email":"agent@example.com","name":"Support"}],"flags":{"answered":true,"draft":true,"flagged":true,"seen":true},"folder_ids":["\u003cstring>"],"from":{"email":"agent@example.com","name":"Support"},"has_attachments":true,"id":"\u003cstring>","keywords":["$seen","$flagged","agent_triaged"],"preview":"\u003cstring>","received_at":"\u003cstring>","sent_at":"\u003cstring>","size_bytes":123,"subject":"\u003cstring>","thread_id":"\u003cstring>","to":[{"email":"agent@example.com","name":"Support"}],"attachments":[{"content_id":"\u003cstring>","content_type":"application/pdf","disposition":"attachment","filename":"invoice.pdf","id":"\u003cstring>","size_bytes":12345,"download_url":"https://app.qubrics.com/api/v1/mailbox/messages/msg_123/attachment-downloads/attref_abc123?download_token=..."}]}],"pagination":{"has_more":true,"next_cursor":"\u003cstring>"}}}},"exampleType":"generated"}},"description":"Message list","exampleType":"generated"},"c69be1ac-ccbd-4c21-836f-af9f4d72632c":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"additionalProperties":false,"properties":{"code":{"description":"Machine-readable error code","enum":["invalid_parameter","missing_parameter","authentication_required","insufficient_permissions","not_found","conflict","limit_exceeded","idempotency_conflict","payload_too_large","validation_error","rate_limit_exceeded","service_unavailable","internal_error"],"example":"invalid_parameter","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error description","type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"description":"Whether the caller may safely retry this request. 4xx are typically false (except 429); 5xx are typically true.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"doc_url":{"description":"Link to relevant documentation","type":"string","uniqueKey":"error.doc_url","typeLabel":"string"},"errors":{"description":"Accumulated per-field issues for validation errors. Only present on 400/422 responses.","items":{"additionalProperties":false,"properties":{"code":{"description":"Machine-readable issue code from the validator (e.g. zod issue code).","example":"invalid_string","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].code","typeLabel":"string"},"field":{"description":"Dot-path of the offending request field.","example":"recipient.email","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].field","typeLabel":"string"},"message":{"description":"Human-readable issue description.","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].message","typeLabel":"string"}},"required":["field","code","message"],"type":"object","uniqueKey":"error.errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"error.errors","typeLabel":"object[]"},"param":{"description":"The parameter that caused the error","type":"string","uniqueKey":"error.param","typeLabel":"string"}},"required":["code","message","retryable"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"meta":{"additionalProperties":false,"properties":{"request_id":{"example":"req_clxxxxxxxxxxxxxxxxxxxxxxxxx","type":"string","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string"}},"required":["request_id"],"type":"object","isRequired":true,"uniqueKey":"meta","typeLabel":"object"},"ok":{"enum":[false],"type":"boolean","isRequired":true,"uniqueKey":"ok","typeLabel":"enum\u003cboolean>"}},"required":["ok","error","meta"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_parameter","message":"\u003cstring>","retryable":false,"doc_url":"\u003cstring>","errors":[{"code":"invalid_string","field":"recipient.email","message":"\u003cstring>"}],"param":"\u003cstring>"},"meta":{"request_id":"req_clxxxxxxxxxxxxxxxxxxxxxxxxx"},"ok":false}}},"exampleType":"generated"}},"description":"Invalid query parameter","exampleType":"generated"},"681bf130-e823-428a-8e19-5c3eac2a4740":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"additionalProperties":false,"properties":{"code":{"description":"Machine-readable error code","enum":["invalid_parameter","missing_parameter","authentication_required","insufficient_permissions","not_found","conflict","limit_exceeded","idempotency_conflict","payload_too_large","validation_error","rate_limit_exceeded","service_unavailable","internal_error"],"example":"invalid_parameter","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error description","type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"description":"Whether the caller may safely retry this request. 4xx are typically false (except 429); 5xx are typically true.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"doc_url":{"description":"Link to relevant documentation","type":"string","uniqueKey":"error.doc_url","typeLabel":"string"},"errors":{"description":"Accumulated per-field issues for validation errors. Only present on 400/422 responses.","items":{"additionalProperties":false,"properties":{"code":{"description":"Machine-readable issue code from the validator (e.g. zod issue code).","example":"invalid_string","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].code","typeLabel":"string"},"field":{"description":"Dot-path of the offending request field.","example":"recipient.email","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].field","typeLabel":"string"},"message":{"description":"Human-readable issue description.","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].message","typeLabel":"string"}},"required":["field","code","message"],"type":"object","uniqueKey":"error.errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"error.errors","typeLabel":"object[]"},"param":{"description":"The parameter that caused the error","type":"string","uniqueKey":"error.param","typeLabel":"string"}},"required":["code","message","retryable"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"meta":{"additionalProperties":false,"properties":{"request_id":{"example":"req_clxxxxxxxxxxxxxxxxxxxxxxxxx","type":"string","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string"}},"required":["request_id"],"type":"object","isRequired":true,"uniqueKey":"meta","typeLabel":"object"},"ok":{"enum":[false],"type":"boolean","isRequired":true,"uniqueKey":"ok","typeLabel":"enum\u003cboolean>"}},"required":["ok","error","meta"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_parameter","message":"\u003cstring>","retryable":false,"doc_url":"\u003cstring>","errors":[{"code":"invalid_string","field":"recipient.email","message":"\u003cstring>"}],"param":"\u003cstring>"},"meta":{"request_id":"req_clxxxxxxxxxxxxxxxxxxxxxxxxx"},"ok":false}}},"exampleType":"generated"}},"description":"Authentication required","exampleType":"generated"},"61dd52a4-3ba5-4db3-b1f0-a416e7502705":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"additionalProperties":false,"properties":{"code":{"description":"Machine-readable error code","enum":["invalid_parameter","missing_parameter","authentication_required","insufficient_permissions","not_found","conflict","limit_exceeded","idempotency_conflict","payload_too_large","validation_error","rate_limit_exceeded","service_unavailable","internal_error"],"example":"invalid_parameter","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error description","type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"description":"Whether the caller may safely retry this request. 4xx are typically false (except 429); 5xx are typically true.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"doc_url":{"description":"Link to relevant documentation","type":"string","uniqueKey":"error.doc_url","typeLabel":"string"},"errors":{"description":"Accumulated per-field issues for validation errors. Only present on 400/422 responses.","items":{"additionalProperties":false,"properties":{"code":{"description":"Machine-readable issue code from the validator (e.g. zod issue code).","example":"invalid_string","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].code","typeLabel":"string"},"field":{"description":"Dot-path of the offending request field.","example":"recipient.email","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].field","typeLabel":"string"},"message":{"description":"Human-readable issue description.","type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].message","typeLabel":"string"}},"required":["field","code","message"],"type":"object","uniqueKey":"error.errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"error.errors","typeLabel":"object[]"},"param":{"description":"The parameter that caused the error","type":"string","uniqueKey":"error.param","typeLabel":"string"}},"required":["code","message","retryable"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"meta":{"additionalProperties":false,"properties":{"request_id":{"example":"req_clxxxxxxxxxxxxxxxxxxxxxxxxx","type":"string","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string"}},"required":["request_id"],"type":"object","isRequired":true,"uniqueKey":"meta","typeLabel":"object"},"ok":{"enum":[false],"type":"boolean","isRequired":true,"uniqueKey":"ok","typeLabel":"enum\u003cboolean>"}},"required":["ok","error","meta"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_parameter","message":"\u003cstring>","retryable":false,"doc_url":"\u003cstring>","errors":[{"code":"invalid_string","field":"recipient.email","message":"\u003cstring>"}],"param":"\u003cstring>"},"meta":{"request_id":"req_clxxxxxxxxxxxxxxxxxxxxxxxxx"},"ok":false}}},"exampleType":"generated"}},"description":"Mailbox API access required","exampleType":"generated"}},"security":{"dfd2d9ef-993d-4b80-a0a2-10f9340146d4":{"bearerAuth":{"bearerFormat":"API Key","description":"Qubrics API key. Use a root API key for Management API routes, or a mailbox credential for Mailbox API routes. Obtain keys from the dashboard under API Keys.","scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"}},"545e5ff5-b589-49ed-aaf1-f05dbb2fde15":{"oauth2":{"description":"Use the authorisation-code flow with S256 PKCE and resource=https://qubrics.com/api. The user selects the team, API access and mailboxes during consent. OAuth access tokens authenticate HTTP API requests; use separate credentials for SMTP and IMAP.","flows":{"authorizationCode":{"authorizationUrl":"https://app.qubrics.com/oauth/authorize","refreshUrl":"https://app.qubrics.com/oauth/token","scopes":{"analytics.*":"All analytics operations","analytics.read":"View key usage analytics and verification logs","billing.*":"All billing operations","billing.auto_topup":"Configure auto top-up settings","billing.read":"View balance, transactions, invoices","billing.topup":"Purchase balance top-ups","calendar.read":"Read calendars and events in this mailbox","calendar.write":"Create calendars and create, edit and delete events in this mailbox","domain.*":"All domain operations","domain.create":"Add sending domains","domain.delete":"Remove domains","domain.read":"List/view domains and DNS status","domain.verify":"Trigger domain verification","email.receive":"Authorise email reception","email.send":"Send email through the HTTP API","key.*":"All key management operations","key.create":"Create new API keys (both root and mailbox)","key.read":"List/view API keys and their metadata","key.revoke":"Revoke API keys","key.rotate":"Rotate API keys","logs.*":"All log operations","logs.read":"View delivery logs","mailbox.admin.*":"All mailbox admin operations","mailbox.admin.create":"Create mailboxes (admin-level)","mailbox.admin.delete":"Delete mailboxes (admin-level)","mailbox.admin.manage":"Manage all mailbox settings","mailbox.admin.read":"List/view mailboxes (admin-level)","mailbox.drafts.write":"Create and edit saved mailbox drafts","mailbox.read":"Read mailbox contents (folders, messages)","mailbox.settings.update":"Update own mailbox settings (signature, auto-reply)","provider.*":"All provider operations","provider.create":"Add email provider accounts (Google, Microsoft, SMTP)","provider.delete":"Remove provider accounts","provider.read":"List/view provider accounts and connection status","provider.update":"Update provider settings, refresh tokens","routing.*":"All routing operations","routing.create":"Create delivery groups","routing.delete":"Remove delivery groups","routing.read":"List/view delivery groups and routing rules","routing.update":"Update delivery group configuration","team.*":"All team operations","team.members.invite":"Invite team members","team.members.remove":"Remove team members","team.members.roles":"Change member roles","team.read":"View team settings and members","team.update":"Update team settings","webhook.*":"All webhook operations","webhook.create":"Create webhook subscriptions","webhook.delete":"Delete webhook subscriptions","webhook.manage":"Rotate signing secret + send test events","webhook.read":"List/view webhook subscriptions","webhook.update":"Update webhook URL, event types, enabled flag"},"tokenUrl":"https://app.qubrics.com/oauth/token"}},"type":"oauth2","scopes":["mailbox.read"],"schemeName":"oauth2"}}},"servers":{"47cfcb91-0c9c-47bb-8bd6-fe2f163124de":{"description":"API v1","url":"https://app.qubrics.com/api/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"bearerFormat":"API Key","description":"Qubrics API key. Use a root API key for Management API routes, or a mailbox credential for Mailbox API routes. Obtain keys from the dashboard under API Keys.","scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Qubrics API key. Use a root API key for Management API routes, or a mailbox credential for Mailbox API routes. Obtain keys from the dashboard under API Keys.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"},{"schemes":[{"scheme":{"description":"Use the authorisation-code flow with S256 PKCE and resource=https://qubrics.com/api. The user selects the team, API access and mailboxes during consent. OAuth access tokens authenticate HTTP API requests; use separate credentials for SMTP and IMAP.","flows":{"authorizationCode":{"authorizationUrl":"https://app.qubrics.com/oauth/authorize","refreshUrl":"https://app.qubrics.com/oauth/token","scopes":{"analytics.*":"All analytics operations","analytics.read":"View key usage analytics and verification logs","billing.*":"All billing operations","billing.auto_topup":"Configure auto top-up settings","billing.read":"View balance, transactions, invoices","billing.topup":"Purchase balance top-ups","calendar.read":"Read calendars and events in this mailbox","calendar.write":"Create calendars and create, edit and delete events in this mailbox","domain.*":"All domain operations","domain.create":"Add sending domains","domain.delete":"Remove domains","domain.read":"List/view domains and DNS status","domain.verify":"Trigger domain verification","email.receive":"Authorise email reception","email.send":"Send email through the HTTP API","key.*":"All key management operations","key.create":"Create new API keys (both root and mailbox)","key.read":"List/view API keys and their metadata","key.revoke":"Revoke API keys","key.rotate":"Rotate API keys","logs.*":"All log operations","logs.read":"View delivery logs","mailbox.admin.*":"All mailbox admin operations","mailbox.admin.create":"Create mailboxes (admin-level)","mailbox.admin.delete":"Delete mailboxes (admin-level)","mailbox.admin.manage":"Manage all mailbox settings","mailbox.admin.read":"List/view mailboxes (admin-level)","mailbox.drafts.write":"Create and edit saved mailbox drafts","mailbox.read":"Read mailbox contents (folders, messages)","mailbox.settings.update":"Update own mailbox settings (signature, auto-reply)","provider.*":"All provider operations","provider.create":"Add email provider accounts (Google, Microsoft, SMTP)","provider.delete":"Remove provider accounts","provider.read":"List/view provider accounts and connection status","provider.update":"Update provider settings, refresh tokens","routing.*":"All routing operations","routing.create":"Create delivery groups","routing.delete":"Remove delivery groups","routing.read":"List/view delivery groups and routing rules","routing.update":"Update delivery group configuration","team.*":"All team operations","team.members.invite":"Invite team members","team.members.remove":"Remove team members","team.members.roles":"Change member roles","team.read":"View team settings and members","team.update":"Update team settings","webhook.*":"All webhook operations","webhook.create":"Create webhook subscriptions","webhook.delete":"Delete webhook subscriptions","webhook.manage":"Rotate signing secret + send test events","webhook.read":"List/view webhook subscriptions","webhook.update":"Update webhook URL, event types, enabled flag"},"tokenUrl":"https://app.qubrics.com/oauth/token"}},"type":"oauth2","scopes":["mailbox.read"],"schemeName":"oauth2"},"schema":{"title":"OAuth2 Auth","type":"string","isRequired":true,"description":"Use the authorisation-code flow with S256 PKCE and resource=https://qubrics.com/api. The user selects the team, API access and mailboxes during consent. OAuth access tokens authenticate HTTP API requests; use separate credentials for SMTP and IMAP.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"oauth2","name":"Authorization"}],"title":"oauth2"}]},"originalFileLocation":"openapi-app.json"},"subdomain":"sendmux","siteName":"Qubrics","title":"List mailbox messages - Qubrics","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-19T05:44:28.427Z","originalFileLocation":"api/mailbox-api/list-mailbox-messages.mdx"},"headHtml":"\u003cscript data-mint-head\u003e(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\u003e\u003cmeta data-mint-head name=\"description\" content=\"Returns a cursor-paginated list of messages for the authenticated mailbox. Requires Mailbox API access.\"\u003e\u003cmeta data-mint-head name=\"application-name\" content=\"Qubrics\"\u003e\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\"\u003e\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/qubrics/QBifi-yrmD9atxWJ/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\"\u003e\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/qubrics/QBifi-yrmD9atxWJ/_generated/favicon/apple-touch-icon.png\"\u003e\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/qubrics/QBifi-yrmD9atxWJ/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\"\u003e\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/qubrics/QBifi-yrmD9atxWJ/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\"\u003e\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/qubrics/QBifi-yrmD9atxWJ/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\"\u003e\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/qubrics/QBifi-yrmD9atxWJ/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\"\u003e\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/qubrics/QBifi-yrmD9atxWJ/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\"\u003e\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/qubrics/QBifi-yrmD9atxWJ/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\"\u003e\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/qubrics/QBifi-yrmD9atxWJ/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\"\u003e\u003cmeta data-mint-head property=\"og:title\" content=\"List mailbox messages - Qubrics\"\u003e\u003cmeta data-mint-head property=\"og:description\" content=\"Returns a cursor-paginated list of messages for the authenticated mailbox. Requires Mailbox API access.\"\u003e\u003cmeta data-mint-head property=\"og:site_name\" content=\"Qubrics\"\u003e\u003cmeta data-mint-head property=\"og:url\" content=\"https://qubrics.com/docs/api/mailbox-api/list-mailbox-messages\"\u003e\u003cmeta data-mint-head property=\"og:type\" content=\"website\"\u003e\u003cmeta data-mint-head property=\"og:image\" content=\"https://qubrics.com/docs/_mintlify/api/og/v2?division=Messages\u0026amp;title=List+mailbox+messages\u0026amp;description=Returns+a+cursor-paginated+list+of+messages+for+the+authenticated+mailbox.+Requires+Mailbox+API+access.\u0026amp;theme=8d3480837e3238732b09c327\u0026amp;signature=fba596f8b82be2e430582bbbee4606374cbbad99f3500971b06de66a550354a2\"\u003e\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\"\u003e\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\"\u003e\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\"\u003e\u003cmeta data-mint-head name=\"twitter:title\" content=\"List mailbox messages - Qubrics\"\u003e\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns a cursor-paginated list of messages for the authenticated mailbox. Requires Mailbox API access.\"\u003e\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://qubrics.com/docs/_mintlify/api/og/v2?division=Messages\u0026amp;title=List+mailbox+messages\u0026amp;description=Returns+a+cursor-paginated+list+of+messages+for+the+authenticated+mailbox.+Requires+Mailbox+API+access.\u0026amp;theme=8d3480837e3238732b09c327\u0026amp;signature=fba596f8b82be2e430582bbbee4606374cbbad99f3500971b06de66a550354a2\"\u003e\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\"\u003e\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\"\u003e\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/sendmux/QBifi-yrmD9atxWJ/_generated/favicon/browserconfig.xml\"\u003e\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Qubrics\"\u003e\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6a75f1\"\u003e\u003clink data-mint-head rel=\"canonical\" href=\"https://qubrics.com/docs/api/mailbox-api/list-mailbox-messages\"\u003e\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\"\u003e\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api/mailbox-api/list-mailbox-messages.md\"\u003e\u003cscript data-mint-head type=\"application/ld+json\"\u003e{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://qubrics.com/#organization\",\"name\":\"Qubrics\",\"url\":\"https://qubrics.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/sendmux/9EML6-L2IAWgIXVX/images/logo-light.svg?fit=max\u0026auto=format\u0026n=9EML6-L2IAWgIXVX\u0026q=85\u0026s=0d301b6a4a28e21cf585335973584967\"}},{\"@type\":\"WebSite\",\"@id\":\"https://qubrics.com/docs#website\",\"name\":\"Qubrics\",\"url\":\"https://qubrics.com/docs\",\"publisher\":{\"@id\":\"https://qubrics.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://qubrics.com/docs/api/mailbox-api/list-mailbox-messages#webpage\",\"url\":\"https://qubrics.com/docs/api/mailbox-api/list-mailbox-messages\",\"name\":\"List mailbox messages\",\"description\":\"Returns a cursor-paginated list of messages for the authenticated mailbox. Requires Mailbox API access.\",\"dateModified\":\"2026-11-19T05:44:28.427Z\",\"isPartOf\":{\"@id\":\"https://qubrics.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://qubrics.com/docs/api/mailbox-api/list-mailbox-messages#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://qubrics.com/docs/api/mailbox-api/list-mailbox-messages#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Qubrics\",\"item\":\"https://qubrics.com/docs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List mailbox messages\",\"item\":\"https://qubrics.com/docs/api/mailbox-api/list-mailbox-messages\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://qubrics.com/docs/api/mailbox-api/list-mailbox-messages#apireference\",\"headline\":\"List mailbox messages\",\"name\":\"List mailbox messages\",\"description\":\"Returns a cursor-paginated list of messages for the authenticated mailbox. Requires Mailbox API access.\",\"url\":\"https://qubrics.com/docs/api/mailbox-api/list-mailbox-messages\",\"mainEntityOfPage\":{\"@id\":\"https://qubrics.com/docs/api/mailbox-api/list-mailbox-messages#webpage\"},\"dateModified\":\"2026-11-19T05:44:28.427Z\",\"publisher\":{\"@id\":\"https://qubrics.com/#organization\"},\"isPartOf\":{\"@id\":\"https://qubrics.com/docs#website\"}}]}\u003c/script\u003e\u003cscript data-mint-head type=\"application/ld+json\"\u003e{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Qubrics\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Qubrics\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script\u003e","agentPointerHref":"/docs/api/mailbox-api/list-mailbox-messages.md","siteName":"Qubrics","nav":{"global":{"anchors":[{"anchor":"App","href":"https://app.qubrics.com"},{"anchor":"Website","href":"https://qubrics.com"}]},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"Management API","pages":[{"title":"Management API","href":"/api/introduction"}]},{"tab":"Mailbox API","groups":[{"group":"Overview","pages":[{"title":"Introduction","href":"/mailbox-api/introduction"},{"title":"Errors","href":"/mailbox-api/errors"},{"title":"Get Mailbox connection","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/connection","href":"/api/mailbox-api/get-mailbox-connection"}]},{"group":"Mailboxes","pages":[{"title":"List granted mailboxes","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/mailboxes","href":"/api/mailbox-api/list-granted-mailboxes"}]},{"group":"Session and identity","pages":[{"title":"Self-introspect the calling mailbox","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/me","href":"/api/mailbox-api/self-introspect-the-calling-mailbox"},{"title":"Get mailbox API session","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/session","href":"/api/mailbox-api/get-mailbox-api-session"},{"title":"Get permitted sender choices","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/sender-choices","href":"/api/mailbox-api/get-permitted-sender-choices"},{"title":"Get mailbox sender identity","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/identity","href":"/api/mailbox-api/get-mailbox-sender-identity"},{"title":"Update mailbox sender identity","deprecated":null,"version":null,"openapi":"/openapi-app.json patch /mailbox/identity","href":"/api/mailbox-api/update-mailbox-sender-identity"},{"title":"List mailbox sender identities","description":"Returns sender identities available to the authenticated mailbox.","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/identities","href":"/api/mailbox-api/list-mailbox-sender-identities"}]},{"group":"Messages","pages":[{"title":"List mailbox messages","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/messages","href":"/api/mailbox-api/list-mailbox-messages"},{"title":"Batch get mailbox messages","description":"Returns exact messages by ID. Use `body_mode` to choose summary-only output, raw body output, or clean JSON content. Attachment output remains metadata only; attachment contents are not parsed.","deprecated":null,"version":null,"openapi":"/openapi-app.json post /mailbox/messages:batch-get","href":"/api/mailbox-api/batch-get-mailbox-messages"},{"title":"Batch update mailbox messages","deprecated":null,"version":null,"openapi":"/openapi-app.json post /mailbox/messages:batch-update","href":"/api/mailbox-api/batch-update-mailbox-messages"},{"title":"Batch delete mailbox messages","deprecated":null,"version":null,"openapi":"/openapi-app.json post /mailbox/messages:batch-delete","href":"/api/mailbox-api/batch-delete-mailbox-messages"},{"title":"Count mailbox messages","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/messages/count","href":"/api/mailbox-api/count-mailbox-messages"},{"title":"Get message query changes","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/messages/query-changes","href":"/api/mailbox-api/get-message-query-changes"},{"title":"Get message search snippets","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/messages/search-snippets","href":"/api/mailbox-api/get-message-search-snippets"},{"title":"Get a mailbox message","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/messages/{message_id}","href":"/api/mailbox-api/get-a-mailbox-message"},{"title":"Get raw message body","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/messages/{message_id}/body","href":"/api/mailbox-api/get-raw-message-body"},{"title":"Get clean message content","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/messages/{message_id}/content","href":"/api/mailbox-api/get-clean-message-content"},{"title":"Download the original message","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/messages/{message_id}/raw","href":"/api/mailbox-api/download-the-original-message"},{"title":"Update mailbox message flags","deprecated":null,"version":null,"openapi":"/openapi-app.json patch /mailbox/messages/{message_id}","href":"/api/mailbox-api/update-mailbox-message-flags"},{"title":"Delete a mailbox message","deprecated":null,"version":null,"openapi":"/openapi-app.json delete /mailbox/messages/{message_id}","href":"/api/mailbox-api/delete-a-mailbox-message"},{"title":"Send a mailbox message","deprecated":null,"version":null,"openapi":"/openapi-app.json post /mailbox/messages/send","href":"/api/mailbox-api/send-a-mailbox-message"}]},{"group":"Saved drafts","pages":[{"title":"List saved drafts","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/drafts","href":"/api/mailbox-api/list-saved-drafts"},{"title":"Create a saved draft","deprecated":null,"version":null,"openapi":"/openapi-app.json post /mailbox/drafts","href":"/api/mailbox-api/create-a-saved-draft"},{"title":"Read a saved draft","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/drafts/{draftId}","href":"/api/mailbox-api/read-a-saved-draft"},{"title":"Edit a saved draft","deprecated":null,"version":null,"openapi":"/openapi-app.json patch /mailbox/drafts/{draftId}","href":"/api/mailbox-api/edit-a-saved-draft"},{"title":"Delete a saved draft","deprecated":null,"version":null,"openapi":"/openapi-app.json delete /mailbox/drafts/{draftId}","href":"/api/mailbox-api/delete-a-saved-draft"},{"title":"Send a saved draft revision","deprecated":null,"version":null,"openapi":"/openapi-app.json post /mailbox/drafts/{draftId}/send","href":"/api/mailbox-api/send-a-saved-draft-revision"},{"title":"Reschedule or cancel a saved draft send","deprecated":null,"version":null,"openapi":"/openapi-app.json patch /mailbox/drafts/{draftId}/schedule","href":"/api/mailbox-api/reschedule-or-cancel-a-saved-draft-send"}]},{"group":"Attachments","pages":[{"title":"Upload a mailbox attachment","deprecated":null,"version":null,"openapi":"/openapi-app.json post /mailbox/attachments:upload","href":"/api/mailbox-api/upload-a-mailbox-attachment"},{"title":"Create a presigned mailbox attachment upload","deprecated":null,"version":null,"openapi":"/openapi-app.json post /mailbox/attachment-uploads","href":"/api/mailbox-api/create-a-presigned-mailbox-attachment-upload"},{"title":"Download a message attachment","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/messages/{message_id}/attachments/{attachment_id}","href":"/api/mailbox-api/download-a-message-attachment"},{"title":"Request attachment text","deprecated":null,"version":null,"openapi":"/openapi-app.json post /mailbox/messages/{message_id}/attachments/{attachment_id}/text","href":"/api/mailbox-api/request-attachment-text"},{"title":"Read attachment text","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/messages/{message_id}/attachments/{attachment_id}/text","href":"/api/mailbox-api/read-attachment-text"}]},{"group":"Threads","pages":[{"title":"List mailbox threads","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/threads","href":"/api/mailbox-api/list-mailbox-threads"},{"title":"Get a mailbox thread","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/threads/{thread_id}","href":"/api/mailbox-api/get-a-mailbox-thread"},{"title":"List thread messages","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/threads/{thread_id}/messages","href":"/api/mailbox-api/list-thread-messages"},{"title":"Get clean thread content","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/threads/{thread_id}/content","href":"/api/mailbox-api/get-clean-thread-content"}]},{"group":"Folders","pages":[{"title":"List mailbox folders","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/folders","href":"/api/mailbox-api/list-mailbox-folders"},{"title":"Create a mailbox folder","deprecated":null,"version":null,"openapi":"/openapi-app.json post /mailbox/folders","href":"/api/mailbox-api/create-a-mailbox-folder"},{"title":"Get folder changes","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/folders/changes","href":"/api/mailbox-api/get-folder-changes"},{"title":"Get folder query changes","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/folders/query-changes","href":"/api/mailbox-api/get-folder-query-changes"},{"title":"Get a mailbox folder","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/folders/{folder_id}","href":"/api/mailbox-api/get-a-mailbox-folder"},{"title":"Update a mailbox folder","deprecated":null,"version":null,"openapi":"/openapi-app.json patch /mailbox/folders/{folder_id}","href":"/api/mailbox-api/update-a-mailbox-folder"},{"title":"Delete a mailbox folder","deprecated":null,"version":null,"openapi":"/openapi-app.json delete /mailbox/folders/{folder_id}","href":"/api/mailbox-api/delete-a-mailbox-folder"}]},{"group":"Submissions","pages":[{"title":"List mailbox submissions","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/submissions","href":"/api/mailbox-api/list-mailbox-submissions"},{"title":"Get submission changes","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/submissions/changes","href":"/api/mailbox-api/get-submission-changes"},{"title":"Get a mailbox submission","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/submissions/{submission_id}","href":"/api/mailbox-api/get-a-mailbox-submission"}]},{"group":"Usage","pages":[{"title":"List mailbox quotas","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/quotas","href":"/api/mailbox-api/list-mailbox-quotas"},{"title":"Get quota changes","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/quotas/changes","href":"/api/mailbox-api/get-quota-changes"},{"title":"Get mailbox usage","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/usage","href":"/api/mailbox-api/get-mailbox-usage"}]},{"group":"Sync","pages":[{"title":"Get mailbox changes","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/changes","href":"/api/mailbox-api/get-mailbox-changes"},{"title":"Stream mailbox events","deprecated":null,"version":null,"openapi":"/openapi-app.json get /mailbox/events","href":"/api/mailbox-api/stream-mailbox-events"}]}]},{"tab":"Sending API","pages":[{"title":"Sending API","href":"/sending-api/introduction"}]}]},"basePath":"","title":"List mailbox messages - Qubrics","deploymentId":"dpl_2MqcLy8smQrrovUehgcZEsoo1tJX","buildId":"dpl_2MqcLy8smQrrovUehgcZEsoo1tJX","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-DyP0AOE1.js","snippetPresets-CuYPAUIG.js","utils-ez5j6NBT.js","style-to-object-BY3JEAdk.js","utils-DG4aeUOF.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DFhcMUrP.js","conditional-requirements-CFM0id0Q.js","cloneDeep-ByDTqllG.js","_Uint8Array-CJ2WjX_H.js","isObject-FP1Yky1u.js","Page-CInwEL5w.js","CodeSnippet-CCk6UVRR.js","DynamicMarkdown-CU5QIokU.js","SectionHeading-BoT1NwPU.js","icon-MsvNhD56.js","ApiExamples-fyn9sMD9.js","usePlaygroundInputsStore-Bf0N_Y6L.js","shallow-CnU26VTn.js","isEqual-OWIKZzop.js","CodeSnippets-CZ9-M31v.js","getApiPlaygroundDisplay-BUw5JwZB.js","MethodPill-CC7p0-fp.js","getPastedJson-BOWYR2ND.js","DuplicateIcon-DOWJyC1b.js","createIcon-BsNyCaLY.js","axios-CsQoIw0U.js","Markdown-L0uigQE0.js","AssistantPageLink-Cur5OU4v.js","dist-CLdzWocy.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}