スレッド

GET /threads?folder=inbox。query を渡すと同じローカルインデックスを検索します。通常の語はすべて含まれている必要があり、それぞれ大文字小文字・アクセント・区切り文字を無視した緩い一致をするので、min は「Benjamin」に一致します。引用符で囲んだフレーズは、大文字小文字とアクセントを除いて書かれたとおりに一致するため、"ben jamin" は「Ben-Jamin」に一致しません。the や emails のような機能語は、他に検索対象が残っていれば通常語の並びから除かれます。from:、to:、subject:、label:、is:unread、has:pdf、after:2026/01/31、newer_than:7d などの演算子で絞り込み、OR、括弧、先頭の - で組み合わせます。受信者は役割を持たない 1 つのリストとして保存され、Bcc は決して保持されないので、cc: は to: と同じフィールドを読み、bcc: は独自には何にも一致しません。from:me は自分が送ったメール、to:me はエイリアスを含む自分のアドレスのいずれかを受信者として、または配送先アドレスとして持つメールです。

語および from:、to:、cc:、subject:、body: 演算子は、各スレッドの最新メッセージ、つまりその送信者、受信者、件名、本文の先頭 4,000 文字を読みます。filename: と has: は会話全体のすべての添付ファイルを読み、label:、in:、is: は会話全体を読みます。folder は、クエリが in: でフォルダーを指定するか、is:sent のようにフォルダーを意味する is: を使わない限り適用され続けます。in:anywhere は単独でも他の条件と並べても、すべてのフォルダーを検索します。下書きの一覧だけは例外で、クエリが何を指定しても下書きにとどまります。

検索が使えない値は絞り込みに使われず無視されるので、値のタイプミスは結果を空にするのではなく広げます。対象は category:、larger:、smaller:、size:、messagesize:、list:、rfc822msgid:、received:、sent:、is:promotions のようなカテゴリー語、添付の種類を指さない has: の語、high でも low でもない importance:、読み取れない日付、単位が h、d、w、m、y のいずれでもない期間です。知らない演算子名、たとえば project: は、通常のテキストとして検索されます。日付はスレッドの最新の活動を UTC で読み、after: は指定した日を含み、before: は含みません。書式は YYYY/MM/DD、YYYY-MM-DD、YYYYMMDD、年のみ、エポック秒またはミリ秒です。

GET /threads/{id} は、最新の 1 通だけでなくスレッド内のすべてのメッセージを、ラベルと未読が含まれているかどうかとともに返します。

この API は暗号化も復号もしません。他人が暗号化したメッセージを開くことはできず、暗号化したメッセージを送ることもできません。暗号化マーカーを持つリクエストは 422 で拒否されます。それを設定してよいのは鍵を持つ面だけであり、API クライアントは鍵を持たないからです。この API が行うのは、受信時に最上位の Content-Type だけを見て封印されたエンベロープを認識し、それをメッセージ上で明示することです。

OpenEmail 自身も今は鍵を持っており、どちらの半分をどこに持つのかは正確に述べる価値があります。メールボックスの所有者はブラウザー内で OpenPGP の識別情報を生成し、公開鍵のほうを、サインイン済みの他の OpenEmail 送信者が参照できるディレクトリーに公開します。秘密鍵のほうはそのブラウザー内で作られ、ここへ送られることはなく、復元もできません。したがってこの API の中に何かを復号できるものはなく、サポート依頼も、召喚状も、当社のバックアップも、鍵を生み出すことはありません。Web アプリは、読み手のブラウザーに鍵があれば PGP/MIME やインライン PGP のメッセージを開けるようになりましたが、その復号はタブの中で起こり、平文が書き戻されることはありません。保存されたメッセージは暗号文のままで、この API のレスポンスが開かれたテキストを運ぶことは決してありません。アプリは新しいメッセージをブラウザー内で封印して送ることもできるようになりました。コンポーザーが受信者の公開鍵に対して暗号化し、メールは PGP/MIME として出ていきます。この API は依然として何も封印できないので、以下のフィールドは、他人が暗号化したメールと OpenEmail のタブ内で封印されたメールの両方を表します。

これがフィールドに値するのは、代わりの結末を考えれば分かります。封印されたメッセージは読める本文を保存しないので、decodedBody は "" として返り、これは本当に中身がなかったメッセージとまったく同じバイト列です。encryption は、行動を起こす前にその 2 つを見分けるためのものであり、検証ではなくエンベロープについての記述です。メッセージが封印されていると分かることは、それを開いたことと同じではありません。

{    "object": "thread",    "id": "thread_2f9b…",    "messages": [      {        "id": "msg_7c41…",        "subject": "Q3 numbers",        "decodedBody": "",        "encryption": {          "format": "pgp-mime",          "detectedAt": "2026-08-30T09:14:22.117Z",          "rawRetained": false,          "parts": [            { "index": 0, "attachmentId": "msg_7c41…-0", "role": "version" },            { "index": 1, "attachmentId": "msg_7c41…-1", "role": "ciphertext" }          ]        }      }    ]  }

変化が生じるのは封印された 3 つの形式だけで、しかもその変化はこのレスポンスではなく取り込み時に起こります。本文を読むはずだったものはすべて手を引きます。暗号文を読んで、得られるはずのない結果を報告するのではなく、次のようにします。

• —本文の検索。メッセージは本文スニペットが空の状態でインデックスされるので、送信者、件名、アドレス、ラベルでは見つかりますが、中身では見つかりません。
• —フィッシング判定の本文パス。判定自体は行われ、何ができなかったかを述べます。risk.signals に body-encrypted が入り、risk.aiChecked は false になります。
• —AI による執筆判定は、推測せずに棄権します。aiWritten.level は unknown、aiWritten.skipped は encrypted になります。
• —ルールの本文条件。エンベロープとヘッダーの条件はこれまでどおり動きます。本文を問うルールは、不一致として数えられるのではなく未評価として記録されます。「一致しなかった」と「読めなかった」は別の答えだからです。
• —カレンダー招待の取り込み。招待は暗号文の中にあり、エンベロープから予定を組み立てれば、実在のカレンダーに誤った項目を入れることになります。
• —スレッドの要約と埋め込みは、スレッド全体で停止します。封印された返信が 1 通あれば十分です。要約とは、モデルが平文を読んだ結果を平文のメタデータとして保存したものであり、このパイプラインの中で、本文が本文とは思われていない保存先へ漏れ出しうる唯一の場所です。

本文を必要としないものは何も変わりません。

• —DMARC、DKIM、SPF。これらは Authentication-Results から読み取られ、暗号文はそれを隠しません。したがって暗号化されたメッセージも、判定なしではなく本物の認証判定を得ます。
• —スレッド化、迷惑メールの振り分け、ブロックリスト。いずれもエンベロープとヘッダーの処理です。
• —添付ファイル。暗号文のパートは attachments に残り、名前がない場合は encrypted-message.asc と名付けられ、下記のエンドポイントからダウンロードできます。これはまさに Web アプリ自身のリーダーが取得してブラウザー内で復号するものであり、鍵を持たない API クライアントにとっては、このダウンロードがそのメールを読む唯一の道です。鍵を持つクライアントで開いてください。
• —署名済みのメッセージは、これらを何も失いません。上記のチェックはすべて実行され続け、何も差し控えられません。だからこそ封印されるのは 5 つではなく 3 つの形式なのです。

PATCH /threads/{id} は read、addLabelIds、removeLabelIds を受け取ります。この製品が対応するすべてのバックエンドで既読状態はラベルなので、read の設定とラベルの移動を 1 回の呼び出しで行うことで順序が決定的になります。

{ "read": true, "addLabelIds": ["USER_INVOICES"] }

GET /threads/{id}/messages/{messageId}/attachments は、各添付ファイルを filename、contentType、size、そして base64 の content とともに返します。保存されたバイト列が見つからなかった場合 content は空文字列になるので、デコードする前に長さを確認してください。