API

ईमेल

इस समूह का हर ऑपरेशन: वह क्या लेता है, क्या लौटाता है और किन त्रुटियों के साथ जवाब दे सकता है।

ऑपरेशन

Send, schedule, cancel and retrieve.

POST`/emails`

Send an email

emails:sendमेल भेजता है

Idempotency-Key का पालन करता है

Sends now, or schedules with scheduledAt. Answers 200 when the message has already gone and 202 when something still has to happen to it, so a caller may branch on the status code. Honours Idempotency-Key.

The body can come from html, text, a stored template, or an existing draftId: one of the four, never two.

Add translate to send it in the recipient's language rather than yours. It is resolved at accept time, before any record of the message exists, so a scheduled send carries the words that were approved and a translation that could not be produced refuses the send rather than delivering the original. Works with template, which is the useful case: the rendered output is what gets translated. See the Languages section, and POST /emails/translate to show somebody the result first.

हेडर

Idempotency-Keystring: Makes a retry safe. Reusing one with a different body is a 422.
अधिकतम 255 वर्णपैटर्न^[A-Za-z0-9_.:-]+$

अनुरोध बॉडी

fromstring | objectआवश्यक

Sender as [email protected], Acme Billing <[email protected]> or { email, name }. It must be an address the key may send as, otherwise 403 from_address_forbidden.

emailstringआवश्यक: अधिकतम 320 वर्ण
namestring: अधिकतम 128 वर्ण

to(string | object)[]आवश्यक

One recipient or a list. to, cc and bcc together hold at most 50 addresses, and more is a 422 too_many_recipients.

1 से 50 आइटम

emailstringआवश्यक: अधिकतम 320 वर्ण
namestring: अधिकतम 128 वर्ण

cc(string | object)[]

Copy recipients, counted toward the 50 recipient ceiling.

अधिकतम 50 आइटमडिफ़ॉल्ट[]

emailstringआवश्यक: अधिकतम 320 वर्ण
namestring: अधिकतम 128 वर्ण

bcc(string | object)[]

Blind copy recipients, counted toward the 50 recipient ceiling.

अधिकतम 50 आइटमडिफ़ॉल्ट[]

emailstringआवश्यक: अधिकतम 320 वर्ण
namestring: अधिकतम 128 वर्ण

replyTostring | object

Written into the Reply-To header.

emailstringआवश्यक: अधिकतम 320 वर्ण
namestring: अधिकतम 128 वर्ण

subjectstring

At most 998 characters. Falls back to the template or draft subject when empty.

अधिकतम 998 वर्णडिफ़ॉल्ट""

htmlstring

HTML body, at most 1,000,000 characters.

अधिकतम 1000000 वर्ण

textstring

Plain text body, at most 1,000,000 characters.

अधिकतम 1000000 वर्ण

templateobject

A stored template by id or slug. Omitting version resolves whatever is published at that moment, so pin it when somebody else owns the copy.

idstringआवश्यक: 1 से 128 वर्ण
versioninteger: 0 से अधिकअधिकतम 100000
propsRecord<string, any>
slotsRecord<string, any>

translateobject

{ to, from?, includeOriginal?, subject? }. to takes a code, an English name or an endonym. includeOriginal and subject both default to true.

tostringआवश्यक: 2 से 60 वर्ण
fromstring: 2 से 60 वर्ण
includeOriginalboolean: डिफ़ॉल्टtrue
subjectboolean: डिफ़ॉल्टtrue

headersRecord<string, string>

Custom headers limited to X-*, List-*, Reply-To, Precedence, Auto-Submitted, Importance, Priority and Feedback-ID. Anything the server sets itself is a 422 reserved_header.

डिफ़ॉल्ट{}

attachmentsobject[]

At most 20 files. Each entry is either an inline file, with filename and content as bytes or a base64 string (bytes are encoded for you, and inline files are capped at 5 MB in total once decoded), or a stored file as { fileId } naming a file already uploaded to the workspace, which is how a file larger than the inline cap is sent.

अधिकतम 20 आइटमडिफ़ॉल्ट[]

filenamestringआवश्यक: 1 से 255 वर्ण
contentstringआवश्यक: 1 से 6990515 वर्णपैटर्न^[A-Za-z0-9+/=\r\n]+$
contentTypestring: अधिकतम 255 वर्णपैटर्न^[\w.+-]+\/[\w.+-]+(?:[ \t]*;[ \t]*[\w.+-]+=(?:"[^"\r\n]*"|[\w.+-]+))*$

attachmentDeliverystring

How the files in attachments travel. mime carries them inside the message, the way mail always has, so a file over 5 MB is refused. link uploads each file and puts a download link in the body in its place, so the message itself stays small. auto links only when the from domain has an active files domain and the files together come to more than 2 MB, and carries them inside the message otherwise, so nothing changes for a domain with no files domain set up. Left out, the sender's mailbox setting applies, and that defaults to auto. A download link uses the files domain when the from domain has one active and the default OpenEmail host otherwise.

इनमें से एक"mime""link""auto"

threadIdstring

Files the sent message into an existing thread.

अधिकतम 256 वर्ण

draftIdstring

Sends an existing draft as written. Cannot be combined with template or translate.

अधिकतम 256 वर्ण

scheduledAtstring

A Date, an ISO 8601 instant or a duration such as PT1H or P2D. At least one second and at most 365 days out.

3 से 64 वर्ण

cancellableForSecondsinteger

An undo window from 0 to 900 seconds on an immediate send. Refused alongside scheduledAt, which is already cancellable until it goes.

कम से कम 0अधिकतम 900डिफ़ॉल्ट0

trackingobject

Open and link tracking for this send alone. A field left out takes the from address's own setting, then its domain's catch-all's when the catch-all caught that address rather than it being one you created, and is on when neither sets it. Set them per address with PATCH /settings?address=.

opensboolean
clicksboolean

signatureboolean

An html body goes out exactly as written, so it carries a signature only when this is true, while a text-only body carries one unless this is false. When it is added it is the from address's own signature, else its domain catch-all's when the catch-all caught that address, else the OpenEmail footer unless that address turned the footer off. Template sends and encrypted sends never carry one.

tagsRecord<string, string>

Up to 10 tags, keys of 1 to 64 letters, digits, _ or -, values up to 256 characters. Echoed back on every read.

डिफ़ॉल्ट{}

लौटाता है

200Email

Sent.

202Email

Accepted: queued or scheduled.

त्रुटियाँ

409: domain_not_sendable: the from domain is known to this workspace but its signing records are not in DNS yet, so nothing was accepted. Or translation_not_configured: this workspace has no AI configured, so translate cannot be honoured.
429: send_quota_exceeded: this workspace has spent the monthly send allowance of its plan, which counts sends from this workspace alone. It resets on the first of the month. Or ai_quota_exceeded: with translate, this workspace has used today's AI actions. Nothing was sent, and it resets at midnight UTC.
503: The translator did not answer. Nothing was sent; the request is worth retrying.

वे त्रुटियाँ जो कोई भी ऑपरेशन लौटा सकता है400401403404422500त्रुटि सूची

इनमें भी उपलब्ध

SDK: emails.send()
CLI: openemail emails send
MCP: replyToEmailsendEmail

GET`/emails`

List sent messages

emails:readपढ़ता है

Newest first, a page at a time. A key limited to particular addresses or domains lists only the messages sent from addresses it covers, and that filter runs before the page is cut, so every page but the last is full.

Requires the emails:read scope.

क्वेरी पैरामीटर

statusstring: Comma-separated.
fromstring: A bare sending address such as [email protected], matched exactly and case insensitively. A display name form does not match.
broadcastIdstring: Only the copies of one broadcast, a brd_ id from POST /broadcasts. Every person a broadcast reaches gets a message of their own, so this is the list of who it went to and what happened to each copy. An id that names no broadcast answers an empty page.
1 से 64 वर्ण
scheduledFromstring: Only messages scheduled for this instant or later, ISO 8601 with a zone. With scheduledTo and status=scheduled,queued it lists what is waiting to go out in a window, as the calendar of the app does. A message with no scheduledAt is left out.
फ़ॉर्मैटdate-time
scheduledTostring: Only messages scheduled for this instant or earlier. scheduledFrom after scheduledTo is a 422 invalid_parameter.
फ़ॉर्मैटdate-time
limitinteger: Rows per page, a whole number from 1 to 100, defaulting to 25. Outside that range is a 422.
कम से कम 1अधिकतम 100डिफ़ॉल्ट25
cursorstring: A message id. Keyset, not offset.

लौटाता है

200EmailList

A page of messages, newest first.

त्रुटियाँ

वे त्रुटियाँ जो कोई भी ऑपरेशन लौटा सकता है400401403404422500त्रुटि सूची

इनमें भी उपलब्ध

SDK: emails.list()emails.listAll()emails.iterate()
CLI: openemail emails list
MCP: listSentEmails

POST`/emails/batch`

Send up to 100 messages

emails:sendमेल भेजता है

Per item, never all-or-nothing: a batch that rolled back on one bad address would make the caller's retry a question of which messages had already gone.

अनुरोध बॉडी

emailsSendEmailRequest[]: अधिकतम 100 आइटम

लौटाता है

207

Per-item results.

त्रुटियाँ

429: This workspace has spent the monthly send allowance of its plan, which counts sends from this workspace alone. It resets on the first of the month.

वे त्रुटियाँ जो कोई भी ऑपरेशन लौटा सकता है400401403404422500त्रुटि सूची

इनमें भी उपलब्ध

SDK: emails.sendBatch()
CLI: openemail emails send-batch

POST`/emails/translate`

Translate a message without sending it

emails:sendपढ़ता है

The same round trip translate makes on a send, stopped one step early. The same function produces both, so what this shows is what would go out.

No scope of its own, deliberately. It grants nothing a sender could not already do, and a scope nobody can tell apart from emails:send on a consent screen makes every other scope on that list mean slightly less.

The body is capped at the same megabyte the send path allows, but translation itself refuses anything over 30,000 characters with translation_too_long. That is a refusal and not a truncation on purpose: half a translated message has no seam to show where it stopped, and the person reading acts on the half they were given.

Requires the emails:send scope.

अनुरोध बॉडी

htmlstring: HTML body to translate. Only the content inside <body> is sent to the model when the markup is a full document.
अधिकतम 1000000 वर्ण
textstring: Plain text body to translate. Translated separately when given alongside html.
अधिकतम 1000000 वर्ण
subjectstring: Subject line to translate, at most 998 characters.
अधिकतम 998 वर्ण
tostringआवश्यक: Target language as a code (de), English name (German) or endonym (Deutsch). An unrecognised value is a 422 invalid_parameter on to.
2 से 60 वर्ण
fromstring: The language you wrote in. Stating it skips the detection call.
2 से 60 वर्ण
includeOriginalboolean: Defaults to true, placing your original text below the translation under a caption in the target language.
डिफ़ॉल्टtrue

लौटाता है

200Translation

The translation. Nothing was sent.

त्रुटियाँ

409: This workspace has no AI configured, so nothing can be translated.
429: ai_quota_exceeded: this workspace has used today's AI actions. It resets at midnight UTC.
503: The translator did not answer. Nothing was sent; the request is worth retrying.

वे त्रुटियाँ जो कोई भी ऑपरेशन लौटा सकता है400401403404422500त्रुटि सूची

इनमें भी उपलब्ध

SDK: emails.translate()
CLI: openemail emails translate
MCP: previewTranslation

POST`/emails/check`

Check how a message would be rated, without sending it

emails:sendपढ़ता है

Scores a message the way a receiving mailbox would, before you send it: a spam score, a phishing score and an AI-writing score, each 0 to 100, with the signals behind them. Run it while someone writes, or before an automated send, and fix what it names.

The same checks score every message that arrives in an OpenEmail mailbox, so what you see here is what an OpenEmail recipient sees in Details. It cannot know a recipient's own filter, sender history or reputation, so a low score is a good sign and not a delivery guarantee.

No scope of its own, for the same reason as the translation preview: it grants nothing a sender could not already do. It spends no AI action and never calls a model.

Requires the emails:send scope.

अनुरोध बॉडी

fromstring: The address it will be sent from.
अधिकतम 320 वर्ण
fromNamestring: The display name it will carry. A name that claims another address or a known brand raises the phishing score.
अधिकतम 320 वर्ण
replyTostring: A Reply-To on a different domain raises the phishing score.
अधिकतम 320 वर्ण
subjectstring: Subject line, at most 998 characters.
अधिकतम 998 वर्णडिफ़ॉल्ट""
htmlstring: HTML body. Links and images are read from it.
अधिकतम 200000 वर्ण
textstring: Plain text body. Taken from html when left out.
अधिकतम 200000 वर्ण
replyingboolean: True when it answers an existing thread. A Re: subject on a message that answers nothing raises the spam score.
attachmentNamesstring[]: File names, so an attachment that can run code is caught.
अधिकतम 100 आइटम

लौटाता है

200EmailCheck

The scores. Nothing was stored or sent.

त्रुटियाँ

वे त्रुटियाँ जो कोई भी ऑपरेशन लौटा सकता है400401403404422500त्रुटि सूची

इनमें भी उपलब्ध

SDK: emails.check()
CLI: openemail emails check
MCP: checkEmail

GET`/emails/{id}`

Retrieve a message

emails:readपढ़ता है

Requires the emails:read scope.

पाथ पैरामीटर

idstringआवश्यक: The send id, msg_ followed by 24 hex characters, as returned by send.

लौटाता है

200Email

The message, with per-recipient state.

त्रुटियाँ

वे त्रुटियाँ जो कोई भी ऑपरेशन लौटा सकता है400401403404422500त्रुटि सूची

इनमें भी उपलब्ध

SDK: emails.get()
CLI: openemail emails get
MCP: getSentEmail

PATCH`/emails/{id}`

Change a message that has not gone yet

emails:sendडेटा बदलता है

Moves it with scheduledAt, and changes what it says or who it goes to with subject, html, text, from, to, cc and bcc, while it is still queued or scheduled. Send any of them together. A recipient list replaces the stored one whole, and from is checked as it is on a send, so it has to be an address the key may send as. A message that was translated when it was accepted keeps its wording, and one that was encrypted keeps its wording and its recipients: cancel it and send again instead.

पाथ पैरामीटर

idstringआवश्यक: The msg_ send id to move.

अनुरोध बॉडी

scheduledAtstring

When it goes out instead: an ISO 8601 instant, or a duration such as PT2H, up to a year out.

3 से 64 वर्ण

subjectstring

The new subject, up to 998 characters.

अधिकतम 998 वर्ण

htmlstring

The new HTML body.

अधिकतम 1000000 वर्ण

textstring

The new plain text body.

अधिकतम 1000000 वर्ण

fromstring

The address it goes out as, checked as it is on a send.

3 से 320 वर्ण

to(string | object)[]

Replaces the stored recipients whole. So do cc and bcc.

1 से 50 आइटम

emailstringआवश्यक: अधिकतम 320 वर्ण
namestring: अधिकतम 128 वर्ण

cc(string | object)[]

Replaces the copied recipients.

अधिकतम 50 आइटम

emailstringआवश्यक: अधिकतम 320 वर्ण
namestring: अधिकतम 128 वर्ण

bcc(string | object)[]

Replaces the blind copied recipients.

अधिकतम 50 आइटम

emailstringआवश्यक: अधिकतम 320 वर्ण
namestring: अधिकतम 128 वर्ण

लौटाता है

200Email

The message as it is now.

त्रुटियाँ

409: email_not_cancellable: it has already gone or was cancelled. translation_locked: it was translated when it was accepted, so its wording cannot change.

वे त्रुटियाँ जो कोई भी ऑपरेशन लौटा सकता है400401403404422500त्रुटि सूची

इनमें भी उपलब्ध

SDK: emails.reschedule()emails.update()
CLI: openemail emails rescheduleopenemail emails update
MCP: rescheduleEmailupdateScheduledEmail

POST`/emails/{id}/cancel`

Cancel a message

emails:sendहटाता है

Idempotent: cancelling twice returns the same cancelled message. A 409 means it has already gone and cannot be un-sent.

पाथ पैरामीटर

idstringआवश्यक: The msg_ send id to cancel.

लौटाता है

200Email

Cancelled.

त्रुटियाँ

409: No longer cancellable.

वे त्रुटियाँ जो कोई भी ऑपरेशन लौटा सकता है400401403404422500त्रुटि सूची

इनमें भी उपलब्ध

SDK: emails.cancel()
CLI: openemail emails cancel
MCP: cancelEmail

GET`/emails/{id}/events`

What happened to a message

emails:readपढ़ता है

The event trail, oldest first, one page at a time. Nothing is dropped from it: a tracked message records an event for every counted open, click and download, so a widely read message runs to many pages, and following nextCursor while hasMore is true reaches the newest event.

Requires the emails:read scope.

पाथ पैरामीटर

idstringआवश्यक: The msg_ send id whose trail to read.

क्वेरी पैरामीटर

limitinteger: Rows per page, 1 to 100.
कम से कम 1अधिकतम 100डिफ़ॉल्ट25
cursorstring: An event id. Keyset, not offset: pass the previous page's nextCursor. One that names nothing in this list is a 400 invalid_cursor.

लौटाता है

200EventList

A page of the event trail, oldest first.

त्रुटियाँ

वे त्रुटियाँ जो कोई भी ऑपरेशन लौटा सकता है400401403404422500त्रुटि सूची

इनमें भी उपलब्ध

SDK: emails.listEvents()emails.listAllEvents()emails.iterateEvents()
CLI: openemail emails list-events
MCP: listEmailEvents

POST`/emails/compose`

Write an email with AI

emails:sendपढ़ता है

Writes the body of an email from prompt, an instruction or a few rough notes, in the style of the mail this workspace has sent before, as the composer of the app does. Give threadId to write a reply: the messages of that thread are read as context, which also needs threads:read. Nothing is saved or sent: pass the result to POST /emails or POST /drafts. It spends one AI action.

Requires the emails:send scope.

अनुरोध बॉडी

promptstringआवश्यक: What to write: an instruction, a rough draft or a few notes.
1 से 20000 वर्ण
subjectstring: The subject so far, if there is one.
अधिकतम 998 वर्ण
tostring[]: Who it goes to, so the greeting and tone fit.
अधिकतम 50 आइटम
ccstring[]: Who is copied.
अधिकतम 50 आइटम
threadIdstring: A thread to reply in. Its messages are read as context, and it needs threads:read.
1 से 200 वर्ण

लौटाता है

200EmailComposition

The body that was written.

त्रुटियाँ

409: ai_not_configured: AI writing is not available on this server.
429: ai_quota_exceeded: this workspace has used the AI actions of its plan for today. Nothing was written, and it resets at midnight UTC.

वे त्रुटियाँ जो कोई भी ऑपरेशन लौटा सकता है400401403404422500त्रुटि सूची

इनमें भी उपलब्ध

SDK: emails.compose()
CLI: openemail emails compose
MCP: composeEmail

POST`/emails/rewrite`

Rewrite part of an email with AI

emails:sendपढ़ता है

Rewrites a subject or a body and answers with up to five different versions, as the rewrite menu of the composer does. action is shorten, lengthen, rephrase, formal, casual or custom, which needs instruction to say what to change. Give threadId when the text is a reply, so the rewrite fits the conversation. Nothing is saved. It spends one AI action.

Requires the emails:send scope.

अनुरोध बॉडी

targetstring: body or subject. Defaults to body.
इनमें से एक"subject""body"डिफ़ॉल्ट"body"
textstringआवश्यक: The subject or body to rewrite.
1 से 100000 वर्ण
actionstringआवश्यक: What to do: shorten, lengthen, rephrase, formal, casual or custom.
इनमें से एक"shorten""lengthen""rephrase""formal""casual""custom"
instructionstring: What to change, up to 500 characters. Required with custom.
अधिकतम 500 वर्ण
countinteger: How many versions, 1 to 5. Defaults to 3.
कम से कम 1अधिकतम 5डिफ़ॉल्ट3
threadIdstring: The thread the text replies in, read as context.
1 से 200 वर्ण

लौटाता है

200EmailRewrite

The versions, best first.

त्रुटियाँ

409: ai_not_configured: AI writing is not available on this server.
429: ai_quota_exceeded: this workspace has used the AI actions of its plan for today. Nothing was written, and it resets at midnight UTC.

वे त्रुटियाँ जो कोई भी ऑपरेशन लौटा सकता है400401403404422500त्रुटि सूची

इनमें भी उपलब्ध

SDK: emails.rewrite()
CLI: openemail emails rewrite
MCP: rewriteEmail

POST`/emails/subject`

Suggest a subject line

emails:sendपढ़ता है

Reads the body of an email and suggests a short subject for it, under 100 characters, in the style of the mail this workspace has sent. Nothing is saved. It spends one AI action.

Requires the emails:send scope.

अनुरोध बॉडी

messagestringआवश्यक: The body of the email, as text or HTML.
1 से 100000 वर्ण

लौटाता है

200SubjectSuggestion

The suggested subject.

त्रुटियाँ

409: ai_not_configured: AI writing is not available on this server.
429: ai_quota_exceeded: this workspace has used the AI actions of its plan for today. Nothing was written, and it resets at midnight UTC.

वे त्रुटियाँ जो कोई भी ऑपरेशन लौटा सकता है400401403404422500त्रुटि सूची

इनमें भी उपलब्ध

SDK: emails.suggestSubject()
CLI: openemail emails suggest-subject
MCP: suggestSubject

ऑब्जेक्ट

`Email`object

objectstring

इनमें से एक"email"

idstring

The durable handle, msg_ + 24 hex.

statusstring

इनमें से एक"queued""scheduled""sending""sent""partial""cancelled""failed"

modestring

इनमें से एक"live""test"

fromstring

subjectstring

null हो सकता है

messageIdstring

RFC 5322 Message-ID. Null until the MIME exists. Do NOT correlate on it: the header is rewritten on the way out, so the value here appears in no bounce or delivery report and a match on it never fires. A delivery event names the send by its id, as emailId.

null हो सकता है

threadIdstring

null हो सकता है

transportstring

How the bytes left, once they have. Null until dispatch. test is what a message sent with an oe_test_ key records: it was accepted and every recipient marked delivered, but nothing was carried. dev is not a way of sending either: it is what a message records where nothing is configured to carry mail, having been built and sent nowhere.

null हो सकता हैइनमें से एक"ses""test""dev"

attemptsinteger

lastErrorstring

null हो सकता है

scheduledAtstring

null हो सकता हैफ़ॉर्मैटdate-time

cancellableUntilstring

null हो सकता हैफ़ॉर्मैटdate-time

sentAtstring

null हो सकता हैफ़ॉर्मैटdate-time

tagsRecord<string, string>

broadcastIdstring

The brd_ broadcast this message is one copy of, or null for a message sent on its own. GET /emails?broadcastId= lists every copy of one broadcast.

null हो सकता है

sourcestring

इनमें से एक"api""oauth""composer""mcp""ai""form"

createdAtstring

फ़ॉर्मैटdate-time

recipientsobject[]

Returned on retrieval only.

emailstring
namestring: null हो सकता है
kindstring: इनमें से एक"to""cc""bcc"
statusstring: uncertain is real and is shown as itself: a transport that failed part-way cannot say which recipients it reached, and calling those delivered or failed would both be guesses. suppressed is decided before dispatch rather than reported afterwards: the address bounced or complained in this workspace before, so this copy was never offered to the transport. A message whose recipients are all suppressed fails outright.
इनमें से एक"pending""delivered""failed""bounced""complained""suppressed""uncertain"
errorstring: null हो सकता है
deliveredAtstring: null हो सकता हैफ़ॉर्मैटdate-time

translationobject

Present only when the message was translated, and only on responses that carry the stored request, which are the send itself and a retrieval. A list row does not fetch it, so its absence there says nothing either way.

languagestring: The resolved target code: de, pt-BR.
languageNamestring: Its English name.
detectedSourceLanguagestring: Stated or detected. Null when detection abstained.
null हो सकता है
subjectboolean: Whether the subject was translated too.
includeOriginalboolean: Whether the sender's own words went below the translation.

trackingTracking

`EmailCheck`object

How a receiving mailbox would likely rate this message, scored from its own content before it is sent. Every score runs 0 to 100, and higher means more of the thing it names. Nothing is stored and nothing is sent.

objectstringआवश्यक

इनमें से एक"email_check"

spamobjectआवश्यक

Spam-like traits in the subject, wording and links: capitals, stacked exclamation marks, stock spam phrases, money or prize bait, link shorteners, an image with almost no text, and a Re: subject on a message that answers nothing.

scoreintegerआवश्यक: कम से कम 0अधिकतम 100
levelstringआवश्यक: medium from 35, high from 60.
इनमें से एक"low""medium""high"
signalsstring[]आवश्यक: What raised the score, heaviest first, as stable ids such as spam-phrases or link-shortener.

phishingobjectआवश्यक

What a phishing filter would object to: link text that names a different site, links to a bare IP address, pressure to verify or pay, an attachment that can run code, and a display name that claims another address or a known brand. Sender authentication is taken as passing, since the message will be signed for your domain.

scoreintegerआवश्यक: कम से कम 0अधिकतम 100
levelstringआवश्यक: caution from 30, danger from 60.
इनमें से एक"clear""caution""danger"
signalsstring[]आवश्यक
reasonsstring[]आवश्यक: One plain sentence per signal, heaviest first.

aiobjectआवश्यक

How much the wording reads as written by a language model, from habits such as stock phrasing, even sentence lengths and markdown. Quoted history and the signature are cut first. It is a score, not a probability, and nobody can prove who wrote a sentence.

scoreintegerआवश्यक: Null when the message was not judged; skipped says why.
null हो सकता हैकम से कम 0अधिकतम 100
levelstringआवश्यक: इनमें से एक"unknown""unremarkable""possible""likely"
signalsstring[]आवश्यक
reasonsstring[]आवश्यक
wordsintegerआवश्यक: Words of your own prose that were read.
skippedstringआवश्यक: too-short under 40 words. Null when it was scored.
null हो सकता हैइनमें से एक"too-short""encrypted""bulk"

`EmailComposition`object

objectstringआवश्यक: इनमें से एक"composition"
bodystringआवश्यक: The body that was written.

`EmailList`object

objectstring: इनमें से एक"list"
dataEmail[]
hasMoreboolean
nextCursorstring: null हो सकता है

`EmailRewrite`object

objectstringआवश्यक: इनमें से एक"rewrite"
targetstringआवश्यक: इनमें से एक"subject""body"
variationsstring[]आवश्यक: Different versions of the text, never the original itself.

`Event`object

objectstring: इनमें से एक"event"
idstring
typestring: Dotted, such as email.accepted, email.sent, email.delivered, email.bounced or email.opened.
dataobject: Whatever the event recorded. An empty object when it carries nothing.
createdAtstring: फ़ॉर्मैटdate-time

`EventList`object

objectstring: इनमें से एक"list"
dataEvent[]
hasMoreboolean: True when another page follows. Pass nextCursor back as cursor to read it.
nextCursorstring: The id of the last row on this page, or null on the last page.
null हो सकता है

`Language`object

codestringआवश्यक: BCP-47. What every endpoint here accepts and returns.
labelstringआवश्यक: The English name: "Brazilian Portuguese".
nativestringआवश्यक: The endonym, in its own script. Show this first.
flagstringआवश्यक: Two regional-indicator codepoints. A scanning aid beside the native name, never an identifier. Never show it on its own.
rtlbooleanआवश्यक: Right-to-left. A translated body for one of these is wrapped in dir="rtl" before it is sent, because a client that inherits direction renders it backwards otherwise.

`SendEmailRequest`object

fromstring | objectआवश्यक

emailstringआवश्यक: अधिकतम 320 वर्ण
namestring: अधिकतम 128 वर्ण

to(string | object)[]आवश्यक

1 से 50 आइटम

emailstringआवश्यक: अधिकतम 320 वर्ण
namestring: अधिकतम 128 वर्ण

cc(string | object)[]

अधिकतम 50 आइटमडिफ़ॉल्ट[]

emailstringआवश्यक: अधिकतम 320 वर्ण
namestring: अधिकतम 128 वर्ण

bcc(string | object)[]

अधिकतम 50 आइटमडिफ़ॉल्ट[]

emailstringआवश्यक: अधिकतम 320 वर्ण
namestring: अधिकतम 128 वर्ण

replyTostring | object

emailstringआवश्यक: अधिकतम 320 वर्ण
namestring: अधिकतम 128 वर्ण

subjectstring

अधिकतम 998 वर्णडिफ़ॉल्ट""

htmlstring

अधिकतम 1000000 वर्ण

textstring

अधिकतम 1000000 वर्ण

templateobject

idstringआवश्यक: 1 से 128 वर्ण
versioninteger: 0 से अधिकअधिकतम 100000
propsRecord<string, any>
slotsRecord<string, any>

translateobject

tostringआवश्यक: 2 से 60 वर्ण
fromstring: 2 से 60 वर्ण
includeOriginalboolean: डिफ़ॉल्टtrue
subjectboolean: डिफ़ॉल्टtrue

headersRecord<string, string>

डिफ़ॉल्ट{}

attachmentsobject[]

अधिकतम 20 आइटमडिफ़ॉल्ट[]

filenamestringआवश्यक: 1 से 255 वर्ण
contentstringआवश्यक: 1 से 6990515 वर्णपैटर्न^[A-Za-z0-9+/=\r\n]+$
contentTypestring: अधिकतम 255 वर्णपैटर्न^[\w.+-]+\/[\w.+-]+(?:[ \t]*;[ \t]*[\w.+-]+=(?:"[^"\r\n]*"|[\w.+-]+))*$

attachmentDeliverystring

इनमें से एक"mime""link""auto"

threadIdstring

अधिकतम 256 वर्ण

draftIdstring

अधिकतम 256 वर्ण

scheduledAtstring

3 से 64 वर्ण

cancellableForSecondsinteger

कम से कम 0अधिकतम 900डिफ़ॉल्ट0

trackingobject

opensboolean
clicksboolean

signatureboolean

tagsRecord<string, string>

डिफ़ॉल्ट{}

`SubjectSuggestion`object

objectstringआवश्यक: इनमें से एक"subject_suggestion"
subjectstringआवश्यक

`Tracking`object

Every /tracking endpoint returns this whole, its list included. It arrives trimmed in exactly one place, under tracking on a GET /emails row, where it is the counts half only: opens, clicks, opened, clicked, openCount, clickCount and firstOpenAt. A page of fifty sends each carrying its recipients and its links is a report nobody asked to have expanded. The trimmed form has no id on it either, so /emails/{id}/tracking rather than /tracking/{id} is the way back to the rest of it.

objectstring

Present when the report is the whole response body. Absent under an email's tracking field, which is part of that email rather than a resource in its own right.

इनमें से एक"tracking"

idstring

The tracking record, tmsg_ + 24 hex. Not the message id and not the send id.

sendIdstring

The msg_ this went out as, when the send service handled it. Null for mail the mailbox agent sent on its own behalf, which is most composer, MCP and assistant traffic. Those messages do get a send record, but nothing links this tracking row to it. Tracking covers the mailbox rather than only the traffic that came through this API.

null हो सकता है

threadIdstring

null हो सकता है

messageIdstring

RFC 5322 Message-ID. Not a correlation key. The header is rewritten on the way out. Correlate on id.

null हो सकता है

subjectstring

null हो सकता है

fromstring

sourcestring

इनमें से एक"api""oauth""composer""mcp""ai""form"

sentAtstring

null हो सकता हैफ़ॉर्मैटdate-time

opensboolean

What was APPLIED to this message, resolved when it was sent from the setting of the address it was sent from (its own, else its domain catch-all's, else off, while a broadcast copy is on unless the broadcast or its address turned it off) and any per-send override, not what is switched on now. Turning tracking on today does not make yesterday's mail start reporting, and a report that implied otherwise would read as "nobody opened it".

clicksboolean

As opens, for link rewriting. The two are independent switches.

openedboolean

clickedboolean

attributableboolean

Whether every reading on this message can be pinned to a named recipient. False as soon as an unattributed copy has activity of its own, which is what happens whenever one body went to the whole list rather than a separate one per person. This is the flag that decides whether "Bob has not opened it" is a sentence a client is entitled to write, or whether all it may say is that somebody did. recipients carries the same fact one row at a time, and one row at a time is where it gets missed.

openCountinteger

Opens that looked like a person, with repeat fetches within thirty seconds collapsed. A preview pane redrawing is not a second reading. Through Gmail this is a floor and not a total: its proxy fetches the image once and caches it, so later readings never reach us.

clickCountinteger

Counted clicks. Stronger evidence than an open, and worth weighting as such: images are blocked far more often than links go unfollowed, so a message with clicks and no opens was certainly read.

openCountRawinteger

Every open hit, the automated ones included. openCountRaw - openCount is everything that was filtered out: Apple Mail Privacy Protection and corporate link scanners, which fetch on delivery whether or not a person ever looks, and alongside them the repeat fetches collapsed by the thirty-second window. Both are recorded and neither is counted, because discarding them outright would leave a gap in the log that nothing could explain. Do not read the difference as a machine count on its own. A message reopened twice in a minute lands in it too.

clickCountRawinteger

As openCountRaw, for clicks.

firstOpenAtstring

null हो सकता हैफ़ॉर्मैटdate-time

lastOpenAtstring

null हो सकता हैफ़ॉर्मैटdate-time

firstClickAtstring

null हो सकता हैफ़ॉर्मैटdate-time

lastClickAtstring

null हो सकता हैफ़ॉर्मैटdate-time

recipientsobject[]

One entry per tracked copy, which is not always one entry per person. Absent only from the trimmed form on a GET /emails row; every /tracking response carries it, list included.

emailstring: Null where the bytes could not be varied per person: an encrypted message, one too large to rebuild for each recipient, or a fallback carrier that takes the whole recipient list in a single call. The reading is real; which of the recipients did it is not knowable, and the only honest rendering is "someone on this message", never a name chosen out of the list.
null हो सकता है
kindstring: null हो सकता हैइनमें से एक"to""cc""bcc"
attributedboolean: False on exactly the rows described above. Branch on this rather than on email being a string, and show nothing where it is false: attributing an unattributed open to a named recipient invents evidence about a specific person.
openCountinteger
clickCountinteger
firstOpenAtstring: null हो सकता हैफ़ॉर्मैटdate-time
lastOpenAtstring: null हो सकता हैफ़ॉर्मैटdate-time
firstClickAtstring: null हो सकता हैफ़ॉर्मैटdate-time
lastClickAtstring: null हो सकता हैफ़ॉर्मैटdate-time

linksobject[]

The rewritten links, in the order they appeared in the message. Only links in the new part of the body are here: the quoted history under a reply belongs to whoever wrote it, and routing their URLs through our redirector would both rewrite their message and record the recipient "clicking" something we did not put there. Repeated destinations share one entry, because a campaign page linked from a header image, a button and a footer is one question asked three times. Absent only from the trimmed form on a GET /emails row.

idstring
urlstring: Where it actually goes: the original href.
labelstring: The text the link read as in the message, where it had any. A bare URL rarely tells the sender which of five links somebody followed.
null हो सकता है
clickCountinteger
clickCountRawinteger

`Translation`object

The preview, and exactly what a translate on POST /emails would produce for the same input. Show it, let someone edit it, then send the edited text as an ordinary html/subject with no translate on the request. Sending with translate after previewing translates a second time and discards the edits.

objectstring: इनमें से एक"translation"
languageLanguage
detectedSourceLanguageLanguage
subjectstring: Null when no subject was given. Safe to put straight into a header.
null हो सकता है
htmlstring: Null when no html was given. Carries dir="rtl" when the target needs it, and already contains the original beneath the translation when includeOriginal is on.
null हो सकता है
textstring: Null when no text was given.
null हो सकता है
includeOriginalboolean: Echoed because it changes what html contains: with it on, the original is already in there and appending your own copy would send it twice.

ईमेल

ऑपरेशन

हेडर

अनुरोध बॉडी

लौटाता है

त्रुटियाँ

इनमें भी उपलब्ध

क्वेरी पैरामीटर

लौटाता है

त्रुटियाँ

इनमें भी उपलब्ध

अनुरोध बॉडी

लौटाता है

त्रुटियाँ

इनमें भी उपलब्ध

अनुरोध बॉडी

लौटाता है

त्रुटियाँ

इनमें भी उपलब्ध

अनुरोध बॉडी

लौटाता है

त्रुटियाँ

इनमें भी उपलब्ध

पाथ पैरामीटर

लौटाता है

त्रुटियाँ

इनमें भी उपलब्ध

पाथ पैरामीटर

अनुरोध बॉडी

लौटाता है

त्रुटियाँ

इनमें भी उपलब्ध

पाथ पैरामीटर

लौटाता है

त्रुटियाँ

इनमें भी उपलब्ध

पाथ पैरामीटर

क्वेरी पैरामीटर

लौटाता है

त्रुटियाँ

इनमें भी उपलब्ध

अनुरोध बॉडी

लौटाता है

त्रुटियाँ

इनमें भी उपलब्ध

अनुरोध बॉडी

लौटाता है

त्रुटियाँ

इनमें भी उपलब्ध

अनुरोध बॉडी

लौटाता है

त्रुटियाँ

इनमें भी उपलब्ध

ऑब्जेक्ट

Emailobject

EmailCheckobject

EmailCompositionobject

EmailListobject

EmailRewriteobject

Eventobject

EventListobject

Languageobject

SendEmailRequestobject

SubjectSuggestionobject

Trackingobject

Translationobject

आपका इनबॉक्स,आपकी अपनी शर्तों पर।

`Email`object

`EmailCheck`object

`EmailComposition`object

`EmailList`object

`EmailRewrite`object

`Event`object

`EventList`object

`Language`object

`SendEmailRequest`object

`SubjectSuggestion`object

`Tracking`object

`Translation`object

आपका इनबॉक्स,
आपकी अपनी शर्तों पर।