SDK

openemail.threads

इस नेमस्पेस का हर मेथड: उसका सिग्नेचर, उसके पैरामीटर, वह क्या लौटाता है और एक उदाहरण।

मेथड

Read, search, label, trash and snooze conversations in the mailbox.

`threads.list()`

List one page of threads in a folder

threads:readनतीजों को पेज दर पेज लाता है

सिग्नेचर

list(options?: ThreadListOptions): Promise<Page<ThreadSummaryResource>>

Returns one page of threads from the mailbox index, ordered by each thread's latest message with the newest first unless sort says otherwise. A row is only object and id, so call get for the messages, labels and unread state.

sort, dateFrom, dateTo and fromContacts are the thread list's own controls: the four orders, a date range read against the newest message on each thread, and a filter to mail from saved contacts. Every order pages to the end, and a cursor carries on in the order it was handed out in, so send the same filters with it.

folder defaults to inbox and is matched against label ids after being upper cased, so sent, archive, spam, trash, draft, snoozed, starred and unread all work, bin is read as trash, and a user label id works as a folder too. A name that matches nothing returns an empty page rather than an error. labelIds narrows the folder further: a thread must carry the folder label and every id you pass.

query takes the mailbox search syntax. Plain words must all appear, and each matches loosely: case, accents and separators are ignored and part of a longer word counts, so min finds "Benjamin". A quoted phrase is matched as written apart from case and accents, so "ben jamin" does not find "Ben-Jamin" while "quarterly invoice" finds "Quarterly invoice". When nothing matches exactly, close spellings are returned instead, so benjimin finds "Benjamin": a plain word, or the value of from:, to:, cc:, subject:, body:, filename: or label:, may differ from the start of a word by one typo when it has four to seven letters and by two when it has eight or more, while a quoted phrase, a word containing a digit, a shorter word and an excluded word still match exactly, and the pages that follow keep matching the same way. Filler words such as the, about or emails are dropped from a list of plain words when something else is left to search for, so emails from john searches for john alone. Operators such as from:, to:, subject:, label:, is:unread, has:pdf, after:2026/01/31 and newer_than:7d narrow it, and OR, parentheses and a leading - combine them. Recipients are stored as one list without roles and never hold a Bcc, so cc: reads the same field as to: and bcc: matches nothing of its own. from:me is mail you sent, and to:me is mail carrying one of your own addresses, aliases included, among its recipients or as the address it was delivered to.

Words and the from:, to:, cc:, subject: and body: operators read only the newest message on each thread: its sender, its recipients, its subject and the first 4,000 characters of its body with markup stripped. filename: and has: read every attachment on the whole conversation, and label:, in: and is: read the whole conversation. A plain word also matches the name of any attachment on the conversation, whichever message carried it. A sealed message has no body text to match. The search stays inside folder unless the query names a folder itself, with in: or a folder is: such as is:sent, and in:anywhere searches every folder, on its own as well as beside other terms. A drafts listing is the exception and stays in drafts whatever the query names.

Dates read the newest activity on the thread, in UTC. after: includes the day it names and before: excludes it, and a date can be written YYYY/MM/DD, YYYY-MM-DD, YYYYMMDD, as a bare year, or as epoch seconds or milliseconds. A short date reads day first (16/09/2026), unless the second number cannot be a month (09/16/2026), and a number above 12 settles it either way. The API pages with an opaque pageToken, which the SDK hands back as nextCursor and accepts as options.cursor.

पैरामीटर

options.folderstring: Label the threads must carry, case insensitive. Defaults to inbox, and bin is read as trash.
options.querystring: Mailbox search. Plain words must all appear and match loosely, a quoted phrase has to appear as written, filler words are dropped when something else is left to search for, and operators such as from:ada, has:pdf and in:anywhere narrow it.
options.labelIdsstring | Array<string>: Label ids a thread must all carry on top of folder, matched exactly. An array is sent comma separated.
options.sortThreadSort: newest (the default), oldest, sender or subject, the four orders of the thread list in the app. sender and subject are alphabetical, newest first within one sender or subject.
options.dateFromDate | string: Keeps threads whose newest message arrived at or after this instant. A Date or an ISO 8601 string with a time and an offset.
options.dateToDate | string: Keeps threads whose newest message arrived at or before this instant. Both ends are included, and dateFrom after dateTo is a 422.
options.fromContactsboolean: When true, keeps only threads whose newest message came from a saved contact. A key limited to some addresses reads the contacts its owner saved.
options.limitnumber: Threads per page, a whole number from 1 to 100. Defaults to 25.
options.cursorstring: The nextCursor of the previous page, passed back unchanged.
options.signalAbortSignal: Cancels the request.
options.apiKeystring: Overrides the client's API key for this call only.

लौटाता है

Page<ThreadSummaryResource> with items, hasMore and nextCursor. Each item is { object: 'thread', id }.

उदाहरण

const page = await openemail.threads.list({ folder: 'inbox', query: 'from:ada has:pdf', limit: 50 }) const lastWeek = await openemail.threads.list({ sort: 'oldest', dateFrom: new Date(Date.now() - 7 * 864e5), fromContacts: true })console.log(lastWeek.items.length) console.log(page.items.map((thread) => thread.id)) if (page.nextCursor) {    const next = await openemail.threads.list({ folder: 'inbox', query: 'from:ada has:pdf', limit: 50, cursor: page.nextCursor })    console.log(next.items.length)}

The server offers a cursor whenever a page comes back full, so hasMore can be true on what turns out to be the last page, and the next call then returns no items.
Threads that arrived in the same instant are ordered by id, so a page boundary between two of them never skips or repeats one.
A thread that receives mail while you page moves ahead of the cursor and is not returned by later pages.
A value query cannot use is ignored rather than narrowing, so a typo in a value widens the result instead of emptying it. That covers category:, larger:, smaller:, size:, messagesize:, list:, rfc822msgid:, received: and sent:, the category words such as is:promotions, a has: word naming no kind of attachment, an importance: other than high or low, an unreadable date and a duration whose unit is not h, d, w, m or y. An operator name it does not know, project: for instance, is searched as plain text.
A narrowed key only sees threads delivered to the addresses it covers, every address on a whole domain it holds included. A thread still has to carry the folder and every one of labelIds, the same as for any other key.

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

API: GET /threads
CLI: openemail threads list

`threads.listAll()`

Collect every thread in a folder into one array

threads:readनतीजों को पेज दर पेज लाता है

सिग्नेचर

listAll(options?: ThreadListOptions): Promise<Array<ThreadSummaryResource>>

Walks every page with the same filters as list and resolves once the last page is in, so the whole result sits in memory at once. That suits a label view or a small folder. For a large inbox, iterate lets you stop as soon as you have what you need.

Each request asks for options.limit threads, 25 when you leave it out, so raising it to 100 needs a quarter of the round trips. Passing options.cursor starts the walk from that page instead of the first. The walk ends at the first empty page or when the server stops offering a cursor.

A failure on any page rejects the promise and discards everything collected so far.

पैरामीटर

options.folderstring: Label the threads must carry, case insensitive. Defaults to inbox.
options.querystring: Mailbox search, as in list. Plain words must all appear and match loosely, a quoted phrase has to appear as written, filler words are dropped when something else is left to search for, and operators such as from:ada, has:pdf and in:anywhere narrow it.
options.labelIdsstring | Array<string>: Label ids a thread must all carry on top of folder, matched exactly.
options.sortThreadSort: newest (the default), oldest, sender or subject, the four orders of the thread list in the app. sender and subject are alphabetical, newest first within one sender or subject.
options.dateFromDate | string: Keeps threads whose newest message arrived at or after this instant. A Date or an ISO 8601 string with a time and an offset.
options.dateToDate | string: Keeps threads whose newest message arrived at or before this instant. Both ends are included, and dateFrom after dateTo is a 422.
options.fromContactsboolean: When true, keeps only threads whose newest message came from a saved contact. A key limited to some addresses reads the contacts its owner saved.
options.limitnumber: Page size for each request, a whole number from 1 to 100. Defaults to 25.
options.cursorstring: A nextCursor to start the walk from instead of the first page.
options.signalAbortSignal: Cancels the request in flight and rejects the whole walk.
options.apiKeystring: Overrides the client's API key for every page of this walk.

लौटाता है

Array<ThreadSummaryResource>, every matching thread as { object: 'thread', id }, newest first.

उदाहरण

const snoozed = await openemail.threads.listAll({ folder: 'snoozed', limit: 100 }) console.log(`${snoozed.length} threads are waiting to wake`)

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

API: GET /threads

`threads.iterate()`

Stream threads one at a time across pages

threads:readनतीजों को पेज दर पेज लाता है

सिग्नेचर

iterate(options?: ThreadListOptions): AsyncGenerator<ThreadSummaryResource, void, undefined>

Returns an async generator that yields threads one by one and requests the next page only when the current one is used up. Nothing is fetched until the loop starts, and breaking out of it stops further requests, so this is the way to scan a large folder for the first match.

Filters behave as in list, and each request asks for options.limit threads, 25 by default. The cursor marks a position in time rather than a row count, so trashing, archiving or relabelling threads inside the loop does not make the walk skip the ones after them. A thread that receives new mail during the walk moves ahead of the cursor and is not yielded again.

पैरामीटर

options.folderstring: Label the threads must carry, case insensitive. Defaults to inbox.
options.querystring: Mailbox search, as in list. Plain words must all appear and match loosely, a quoted phrase has to appear as written, filler words are dropped when something else is left to search for, and operators such as from:ada, has:pdf and in:anywhere narrow it.
options.labelIdsstring | Array<string>: Label ids a thread must all carry on top of folder, matched exactly.
options.sortThreadSort: newest (the default), oldest, sender or subject, the four orders of the thread list in the app. sender and subject are alphabetical, newest first within one sender or subject.
options.dateFromDate | string: Keeps threads whose newest message arrived at or after this instant. A Date or an ISO 8601 string with a time and an offset.
options.dateToDate | string: Keeps threads whose newest message arrived at or before this instant. Both ends are included, and dateFrom after dateTo is a 422.
options.fromContactsboolean: When true, keeps only threads whose newest message came from a saved contact. A key limited to some addresses reads the contacts its owner saved.
options.limitnumber: Page size for each request, a whole number from 1 to 100. Defaults to 25.
options.cursorstring: A nextCursor to start from instead of the first page.
options.signalAbortSignal: Cancels the request in flight and ends the iteration with that error.
options.apiKeystring: Overrides the client's API key for every page of this walk.

लौटाता है

AsyncGenerator<ThreadSummaryResource, void, undefined> yielding { object: 'thread', id } per step.

उदाहरण

for await (const summary of openemail.threads.iterate({ folder: 'inbox', query: 'receipt newer_than:30d', limit: 100 })) {    const thread = await openemail.threads.get(summary.id)     if (thread.hasUnread) {        await openemail.threads.update(summary.id, { read: true })    }}

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

API: GET /threads

`threads.get()`

Read a thread with every message on it

threads:read

सिग्नेचर

get(id: string, options?: RequestScope): Promise<ThreadResource>

Returns the whole conversation, oldest message first, with the labels the thread sits in and its unread state. Unsent draft replies are included in messages with isDraft: true, which is why messageCount, the length of messages, can be higher than totalReplies, which counts only real messages.

Messages are passed through as the mailbox stored them, so MessageResource is an open record rather than a fixed field list. The one field the API commits to is encryption. When encryption.format is pgp-mime, pgp-inline or smime-encrypted, the message is sealed and its body is empty or holds armour. pgp-signed and smime-signed are ordinary readable mail. A message with no encryption at all was stored before detection existed, so its absence says nothing about whether it was plaintext.

Each message's tags and unread are overwritten on read with the thread's current labels and unread flag, so they describe the thread and not that one message.

पैरामीटर

idstringआवश्यक: Thread id, as returned by list or carried on a message.
options.signalAbortSignal: Cancels the request.
options.apiKeystring: Overrides the client's API key for this call only.

लौटाता है

ThreadResource with id echoed from the request, messages, labels as { id, name, color }, messageCount, hasUnread, totalReplies and deliveredTo, the workspace address the thread belongs to (null when none was recorded).

उदाहरण

const thread = await openemail.threads.get('CAHk7pQ2x9LmZ4-mail.example.com')const sealedFormats = ['pgp-mime', 'pgp-inline', 'smime-encrypted'] for (const message of thread.messages) {    const sealed = sealedFormats.includes(String(message.encryption?.format))    console.log(message.id, message.subject, sealed ? 'sealed' : 'readable')} console.log(thread.labels.map((label) => label.id))

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

API: GET /threads/{id}
CLI: openemail threads get

`threads.update()`

Mark a thread read or unread and change its labels

threads:write

सिग्नेचर

update(id: string, patch: ThreadPatch, options?: RequestScope): Promise<UpdatedThreadResource>

Adds and removes labels on a thread in one call. read is shorthand for the UNREAD label: true removes it and false adds it. At least one of read, a non empty addLabelIds or a non empty removeLabelIds is required, each list takes at most 50 ids, and any other key is a 422 because the body is strict.

Folders are labels too, so archiving is addLabelIds: ['ARCHIVE'] with removeLabelIds: ['INBOX'], the same pair the app uses. TRASH, SNOOZED and DRAFT are refused in either list with 422 label_not_directly_settable, because each needs a step this route cannot take. Use trash and snooze for those.

User label ids come from labels.list, and the system ids such as ARCHIVE, STARRED and UNREAD are taken in any case. An id in addLabelIds that names no label is refused with 422 label_not_found and nothing on the thread changes, so create the label with labels.create first. An unknown id in removeLabelIds is not an error, since the thread cannot carry it. Removals are applied before additions, so an id in both lists ends up on the thread.

पैरामीटर

idstringआवश्यक: Thread id.
patch.readboolean: true removes UNREAD, false adds it.
patch.addLabelIdsArray<string>: Label ids to put on the thread, at most 50, each naming a label, never TRASH, SNOOZED or DRAFT.
patch.removeLabelIdsArray<string>: Label ids to take off the thread, at most 50, never TRASH, SNOOZED or DRAFT.
options.signalAbortSignal: Cancels the request.
options.apiKeystring: Overrides the client's API key for this call only.

लौटाता है

UpdatedThreadResource with id, addedLabelIds and removedLabelIds. Both lists echo the request, with system ids upper cased, plus the UNREAD change that read implies, not what actually changed.

उदाहरण

const updated = await openemail.threads.update('CAHk7pQ2x9LmZ4-mail.example.com', {    read: true,    addLabelIds: ['ARCHIVE', 'USER_RECEIPTS'],    removeLabelIds: ['INBOX']}) console.log(updated.addedLabelIds, updated.removedLabelIds)

The SDK retries this call after a network failure or a retryable status, which is safe because adding a label already present or removing one already gone changes nothing.
The thread is looked up before the body is validated, so a wrong id is a 404 even when the patch is also invalid.
User label ids look like USER_RECEIPTS. Take them from labels.list rather than building them.

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

API: PATCH /threads/{id}
CLI: openemail threads update

`threads.trash()`

Move a thread to the Bin

threads:write

सिग्नेचर

trash(id: string, options?: RequestScope): Promise<TrashedThreadResource>

Adds TRASH and removes INBOX, SPAM, SNOOZED and ARCHIVE in one step, which is what the app's delete does. Doing half of that through update would leave the thread listed in both the Bin and its old folder, which is why update refuses TRASH.

Nothing is deleted. The thread stays readable with get and lists under folder: 'trash'. Calling this on a thread that is already in the Bin changes nothing and returns the same body, which is why the SDK retries it.

पैरामीटर

idstringआवश्यक: Thread id.
options.signalAbortSignal: Cancels the request.
options.apiKeystring: Overrides the client's API key for this call only.

लौटाता है

TrashedThreadResource, { object: 'thread', id, trashed: true }.

उदाहरण

const result = await openemail.threads.trash('CAHk7pQ2x9LmZ4-mail.example.com') console.log(result.id, result.trashed)

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

API: POST /threads/{id}/trash
CLI: openemail threads trash

`threads.snooze()`

Hide a thread until a set time

threads:write

सिग्नेचर

snooze(id: string, wakeAt: Date | string, options?: RequestScope): Promise<SnoozedThreadResource>

Adds SNOOZED, removes INBOX and stores a wake time, all in one call. Both halves matter: the label hides the thread and the stored wake time is what brings it back. A thread labelled SNOOZED any other way would never return, which is why update refuses that label.

wakeAt takes a Date or an ISO 8601 string. The SDK converts a Date with toISOString(), and the server answers 422 invalid_parameter on wakeAt when the value does not parse or is not in the future. Snoozing a thread that is already snoozed replaces its wake time.

Threads are woken by an hourly sweep, so one comes back at the first sweep after wakeAt, up to about an hour late. Opening the Snoozed folder in the app wakes overdue threads straight away. A thread always wakes into the inbox.

पैरामीटर

idstringआवश्यक: Thread id.
wakeAtDate | stringआवश्यक: When the thread should return, a future instant.
options.signalAbortSignal: Cancels the request.
options.apiKeystring: Overrides the client's API key for this call only.

लौटाता है

SnoozedThreadResource with id and snoozedUntil, the wake time normalised to a UTC ISO string.

उदाहरण

const wakeAt = new Date()wakeAt.setUTCDate(wakeAt.getUTCDate() + 1)wakeAt.setUTCHours(9, 0, 0, 0) const snoozed = await openemail.threads.snooze('CAHk7pQ2x9LmZ4-mail.example.com', wakeAt) console.log(snoozed.snoozedUntil)

Only INBOX is removed, so a thread snoozed from another folder keeps that folder's label while it sleeps and wakes carrying both.
A string with no zone offset is read in the server's local zone, so send Z or an explicit offset.
The SDK retries this call, which is safe because a repeat stores the same wake time.

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

API: POST /threads/{id}/snooze
CLI: openemail threads snooze

`threads.unsnooze()`

Bring a snoozed thread back now

threads:write

सिग्नेचर

unsnooze(id: string, options?: RequestScope): Promise<SnoozedThreadResource>

Adds INBOX, removes SNOOZED and deletes the stored wake time, so the thread returns immediately and the hourly sweep leaves it alone afterwards.

A thread that is not snoozed is left where it is, so an archived thread stays archived, and the response still reports snoozedUntil: null.

पैरामीटर

idstringआवश्यक: Thread id.
options.signalAbortSignal: Cancels the request.
options.apiKeystring: Overrides the client's API key for this call only.

लौटाता है

SnoozedThreadResource with id and snoozedUntil set to null.

उदाहरण

const thread = await openemail.threads.get('CAHk7pQ2x9LmZ4-mail.example.com') if (thread.labels.some((label) => label.id === 'SNOOZED')) {    const result = await openemail.threads.unsnooze(thread.id)    console.log(result.snoozedUntil)}

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

API: POST /threads/{id}/unsnooze
CLI: openemail threads unsnooze

`threads.listAttachments()`

List a message's attachments with their content

threads:read

सिग्नेचर

listAttachments(id: string, messageId: string, options?: RequestScope): Promise<Array<AttachmentResource>>

Returns the attachments of one message with each file's bytes inlined as base64 in content. The thread is checked first and then the message, so a messageId that is not on that thread is a 404 even when it exists elsewhere in the mailbox. Take message ids from the messages of threads.get.

This is the display list. The ciphertext of an encrypted envelope is in it and downloads like any other file, named encrypted-message.asc when it arrived without a name. The PGP/MIME version part and any detached signature are held out on purpose. Every part keeps its id in the message's encryption.parts, and for those two the id is a correlation key only: no route returns their bytes.

Every file comes back whole in a single response, with no size cap and no range reads, so a message carrying large files makes a large response.

पैरामीटर

idstringआवश्यक: Thread id the message belongs to.
messageIdstringआवश्यक: Message id from that thread's messages.
options.signalAbortSignal: Cancels the request.
options.apiKeystring: Overrides the client's API key for this call only.

लौटाता है

Array<AttachmentResource>, each with attachmentId, filename, contentType, size and base64 content.

उदाहरण

const thread = await openemail.threads.get('CAHk7pQ2x9LmZ4-mail.example.com')const latest = thread.messages[thread.messages.length - 1]const files = await openemail.threads.listAttachments(thread.id, String(latest.id)) for (const file of files) {    const bytes = Buffer.from(file.content ?? '', 'base64')    console.log(file.filename, file.contentType, bytes.byteLength)}

When the stored bytes for a file cannot be found, content is an empty string rather than null, so check its length before decoding.
Both ids must match: a real message id paired with the wrong thread id is a 404 resource_not_found.
A thread delivered to no address the key covers is a 404 before the message is looked at.

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

API: GET /threads/{id}/messages/{messageId}/attachments
CLI: openemail threads list-attachments

`threads.listNotes()`

List the notes on a thread

threads:read

सिग्नेचर

listNotes(id: string, options?: RequestScope): Promise<Array<ThreadNoteResource>>

Resolves every note on one thread, the Notes panel of the reading pane: pinned notes first, then the rest in the order they were arranged.

Notes are private to a person. A key reads and writes the notes of the workspace owner, and an app those of the person who connected it. A key limited to particular addresses reaches only the notes on threads that arrived at them.

पैरामीटर

idstringआवश्यक: Thread id.
options.signalAbortSignal: Cancels the request.
options.apiKeystring: Overrides the client's API key for this call only.

लौटाता है

Array<ThreadNoteResource>, each with id, threadId, content, color, pinned, order, createdAt and updatedAt.

उदाहरण

const notes = await openemail.threads.listNotes('CAHk7pQ2x9LmZ4-mail.example.com') for (const note of notes) console.log(note.pinned ? 'pinned' : '', note.content)

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

API: GET /threads/{id}/notes
CLI: openemail threads list-notes

`threads.createNote()`

Add a note to a thread

threads:write

सिग्नेचर

createNote(id: string, body: ThreadNoteCreate, options?: RequestScope): Promise<ThreadNoteResource>

Pins a private note to a thread, as the Notes panel does. A new note goes after the others, and pinned keeps it at the top.

पैरामीटर

idstringआवश्यक: Thread id.
body.contentstringआवश्यक: The text of the note, up to 20,000 characters. Leading and trailing spaces are trimmed.
body.colorThreadNoteColor: One of the eight the app offers: default, red, orange, yellow, green, blue, purple or pink. Defaults to default.
body.pinnedboolean: Keeps the note above the others. Defaults to false.
options.signalAbortSignal: Cancels the request.
options.apiKeystring: Overrides the client's API key for this call only.

लौटाता है

ThreadNoteResource for the new note.

उदाहरण

const note = await openemail.threads.createNote('CAHk7pQ2x9LmZ4-mail.example.com', {    content: 'Waiting on the signed contract before replying.',    color: 'yellow',    pinned: true}) console.log(note.id)

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

API: POST /threads/{id}/notes
CLI: openemail threads create-note

`threads.updateNote()`

Change a note

threads:write

सिग्नेचर

updateNote(id: string, noteId: string, patch: ThreadNoteUpdate, options?: RequestScope): Promise<ThreadNoteResource>

Changes the text of a note, its colour or whether it is pinned. Give at least one of the three. A note id that is not on this thread is a 404, even when the note exists on another thread.

पैरामीटर

idstringआवश्यक: Thread id.
noteIdstringआवश्यक: The note's id, from listNotes.
patch.contentstring: The new text, up to 20,000 characters.
patch.colorThreadNoteColor: The new colour.
patch.pinnedboolean: Pins or unpins it.
options.signalAbortSignal: Cancels the request.
options.apiKeystring: Overrides the client's API key for this call only.

लौटाता है

ThreadNoteResource as it is now.

उदाहरण

const note = await openemail.threads.updateNote('CAHk7pQ2x9LmZ4-mail.example.com', 'b3d1f0c2-7a4e-4f7b-9c1d-2e8f6a5b4c3d', { pinned: false }) console.log(note.pinned)

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

API: PATCH /threads/{id}/notes/{noteId}
CLI: openemail threads update-note

`threads.deleteNote()`

Delete a note

threads:write

सिग्नेचर

deleteNote(id: string, noteId: string, options?: RequestScope): Promise<DeletedThreadNoteResource>

Deletes a note for good. There is no bin for notes.

पैरामीटर

idstringआवश्यक: Thread id.
noteIdstringआवश्यक: The note's id, from listNotes.
options.signalAbortSignal: Cancels the request.
options.apiKeystring: Overrides the client's API key for this call only.

लौटाता है

DeletedThreadNoteResource, { object: 'note', id, threadId, deleted: true }.

उदाहरण

await openemail.threads.deleteNote('CAHk7pQ2x9LmZ4-mail.example.com', 'b3d1f0c2-7a4e-4f7b-9c1d-2e8f6a5b4c3d')

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

API: DELETE /threads/{id}/notes/{noteId}
CLI: openemail threads delete-note

`threads.reorderNotes()`

Arrange the notes on a thread

threads:write

सिग्नेचर

reorderNotes(id: string, ids: Array<string>, options?: RequestScope): Promise<Array<ThreadNoteResource>>

Sets the order of every note on a thread at once, first to last, as dragging them in the Notes panel does. Pinned notes still come first.

ids has to name every note on the thread exactly once. Anything else is a 422 invalid_parameter on ids, and nothing moves.

पैरामीटर

idstringआवश्यक: Thread id.
idsArray<string>आवश्यक: Every note id on the thread, in the order you want them.
options.signalAbortSignal: Cancels the request.
options.apiKeystring: Overrides the client's API key for this call only.

लौटाता है

Array<ThreadNoteResource> in the new order.

उदाहरण

const notes = await openemail.threads.listNotes('CAHk7pQ2x9LmZ4-mail.example.com')const reversed = notes.map((note) => note.id).reverse() await openemail.threads.reorderNotes('CAHk7pQ2x9LmZ4-mail.example.com', reversed)

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

API: POST /threads/{id}/notes/reorder
CLI: openemail threads reorder-notes

`threads.counts()`

Count the mail in each folder

threads:read

सिग्नेचर

counts(options?: ThreadCountsOptions): Promise<MailboxCountsResource>

Resolves what the sidebar of the app shows: how many conversations each folder holds and how many of them are unread, and how many inbox conversations arrived at each address of the workspace.

folders has one row per folder, named by its label id in lower case: inbox, sent, spam, archive, trash and snoozed, then unread, whose count is the unread conversations in the inbox. addresses counts the inbox per address the mail was delivered to, with null for mail that recorded none.

A key limited to particular addresses counts only the mail that arrived at them. address narrows every count to one address, and one the key does not reach counts nothing rather than failing.

पैरामीटर

options.addressstring: Count only the mail delivered to this address.
options.signalAbortSignal: Cancels the request.
options.apiKeystring: Overrides the client's API key for this call only.

लौटाता है

MailboxCountsResource, { object: 'mailbox_counts', folders, addresses }, each folder { label, count, unread } and each address { address, count }.

उदाहरण

const counts = await openemail.threads.counts() const inbox = counts.folders.find((folder) => folder.label === 'inbox') console.log(`${inbox?.unread ?? 0} unread of ${inbox?.count ?? 0}`) for (const row of counts.addresses) console.log(row.address ?? '(none)', row.count)

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

API: GET /threads/counts
CLI: openemail threads counts

`threads.summary()`

Read the summary of a thread

threads:read

सिग्नेचर

summary(id: string, options?: RequestScope): Promise<ThreadAiSummaryResource>

Resolves the short AI summary the reading pane shows above a thread. A summary is written once and kept, and written again when a new message arrives, so reading one is cheap.

state is ready with the text in summary, pending while one is being written, or none when there is nothing to summarise, such as a thread holding a message that arrived encrypted, whose body OpenEmail never reads. A pending answer starts the writing, so ask again a few seconds later.

पैरामीटर

idstringआवश्यक: Thread id.
options.signalAbortSignal: Cancels the request.
options.apiKeystring: Overrides the client's API key for this call only.

लौटाता है

ThreadAiSummaryResource, { object: 'thread_summary', threadId, state, summary }, with summary null unless state is ready.

उदाहरण

let result = await openemail.threads.summary('CAHk7pQ2x9LmZ4-mail.example.com') if (result.state === 'pending') {    await new Promise((resolve) => setTimeout(resolve, 5000))    result = await openemail.threads.summary('CAHk7pQ2x9LmZ4-mail.example.com')} console.log(result.summary ?? result.state)

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

API: GET /threads/{id}/summary
CLI: openemail threads summary

`threads.restore()`

Take a thread out of the Bin

threads:write

सिग्नेचर

restore(id: string, options?: RequestScope): Promise<RestoredThreadResource>

Puts a thread back in the inbox, out of the Bin and out of Spam, which is what Restore from Bin and Move to inbox do in the app. It is the undo of trash.

Calling it on a thread that is already in the inbox changes nothing and returns the same body, which is why the SDK retries it.

पैरामीटर

idstringआवश्यक: Thread id.
options.signalAbortSignal: Cancels the request.
options.apiKeystring: Overrides the client's API key for this call only.

लौटाता है

RestoredThreadResource, { object: 'thread', id, restored: true }.

उदाहरण

await openemail.threads.trash('CAHk7pQ2x9LmZ4-mail.example.com') const restored = await openemail.threads.restore('CAHk7pQ2x9LmZ4-mail.example.com') console.log(restored.restored)

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

API: POST /threads/{id}/restore
CLI: openemail threads restore

`threads.delete()`

Delete a thread for good

threads:write

सिग्नेचर

delete(id: string, options?: RequestScope): Promise<DeletedThreadResource>

Deletes every message in a thread, with its attachments, which is what Delete from Bin does in the app. It cannot be undone.

It works on a thread in any folder, so call trash instead when you only mean to throw the thread away: a trashed thread stays readable and restore brings it back.

पैरामीटर

idstringआवश्यक: Thread id.
options.signalAbortSignal: Cancels the request.
options.apiKeystring: Overrides the client's API key for this call only.

लौटाता है

DeletedThreadResource, { object: 'thread', id, deleted: true }.

उदाहरण

await openemail.threads.delete('CAHk7pQ2x9LmZ4-mail.example.com')

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

API: DELETE /threads/{id}
CLI: openemail threads delete

`threads.unsubscribe()`

Unsubscribe from the sender of a thread

threads:write

सिग्नेचर

unsubscribe(id: string, options?: RequestScope): Promise<UnsubscribeResultResource>

Does what the Unsubscribe button of the reading pane does: finds the subscription behind the newest message of the thread that carries a List-Unsubscribe header and unsubscribes from it the way the sender asks for, with a one-click request or an unsubscribe email. A sender that only offers a page cannot be unsubscribed by a program, so method is link and url is the page a person has to open.

A thread with no unsubscribe header is a 422 unsubscribe_unsupported, and a thread delivered to no address the key covers is a 404.

पैरामीटर

idstringआवश्यक: Thread id.
options.signalAbortSignal: Cancels the request.
options.apiKeystring: Overrides the client's API key for this call only.

लौटाता है

UnsubscribeResultResource, { object: 'unsubscribe', threadId, subscriptionId, method, url, binned }.

उदाहरण

const result = await openemail.threads.unsubscribe('CAHk7pQ2x9LmZ4-mail.example.com') console.log(result.method)

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

API: POST /threads/{id}/unsubscribe
CLI: openemail threads unsubscribe

`threads.getEvent()`

Read the event a thread carries

calendar:read

सिग्नेचर

getEvent(id: string, options?: RequestScope): Promise<CalendarEventResource>

Returns the calendar event that came with an invitation in the thread, as the invitation card of the reading pane shows it. Answer it with calendar.respondToEvent.

पैरामीटर

idstringआवश्यक: Thread id, as threads.list returns it.
options.signalAbortSignal: Cancels the request.
options.apiKeystring: Overrides the client's API key for this call only.

लौटाता है

CalendarEventResource, as calendar.getEvent returns it.

उदाहरण

const event = await openemail.threads.getEvent('thr_6d1a9c4e2b7f30d85e1c4a92') console.log(event.summary, event.start)

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

API: GET /threads/{id}/event
CLI: openemail threads get-event

openemail.threads

मेथड

पैरामीटर

लौटाता है

उदाहरण

टिप्पणियाँ

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

पैरामीटर

लौटाता है

उदाहरण

टिप्पणियाँ

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

पैरामीटर

लौटाता है

उदाहरण

टिप्पणियाँ

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

पैरामीटर

लौटाता है

उदाहरण

टिप्पणियाँ

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

पैरामीटर

लौटाता है

उदाहरण

टिप्पणियाँ

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

पैरामीटर

लौटाता है

उदाहरण

टिप्पणियाँ

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

पैरामीटर

लौटाता है

उदाहरण

टिप्पणियाँ

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

पैरामीटर

लौटाता है

उदाहरण

टिप्पणियाँ

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

पैरामीटर

लौटाता है

उदाहरण

टिप्पणियाँ

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

पैरामीटर

लौटाता है

उदाहरण

टिप्पणियाँ

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

पैरामीटर

लौटाता है

उदाहरण

टिप्पणियाँ

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

पैरामीटर

लौटाता है

उदाहरण

टिप्पणियाँ

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

पैरामीटर

लौटाता है

उदाहरण

टिप्पणियाँ

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

पैरामीटर

लौटाता है

उदाहरण

टिप्पणियाँ

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

पैरामीटर

लौटाता है

उदाहरण

टिप्पणियाँ

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

पैरामीटर

लौटाता है

उदाहरण

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