API
最近のメールでラベルを試す
AI が付けるラベルが、受信箱の最新のメールのうちどれに当てはまるか。ラベルは何にも付けません。
POST/labels/{id}/test
実際の呼び出しをワークスペースに対して実行します。
POST /labels/{id}/test
AI が付けるラベルが、受信箱の最新のメールのうちどれに当てはまるか。ラベルは何にも付けません。
例
labels:write と threads:read が必要です。まだ保存していない文面を試すには aiInstructions を送り、ラベルに保存されている内容を試すには {} を送ります。
curl -X POST "$OE/labels/USER_INVOICES/test" -H "$AUTH" -H "Content-Type: application/json" \ -d '{ "aiInstructions": "invoices and receipts" }'{ "object": "label_test", "labelId": "USER_INVOICES", "examined": 20, "matched": [ { "threadId": "thr_7c1e4a90", "subject": "Your September invoice", "sender": "[email protected]", "receivedOn": "Wed, 23 Sep 2026 10:02:44 +0000" } ]}受信箱の最新のスレッド 20 件を読み、examined が実際に読んだ件数を示します。暗号化されて届いたメッセージは読み飛ばされ、特定のアドレスに限定されたキーは、そのアドレスに配信されたスレッドだけを読みます。
1 回試すごとに、呼び出し元の AI アクションを 1 回分使います。届くメールへのラベル付けでは、これは決して起こりません。今日の分が残っていない場合は 429 ai_quota_exceeded、リクエストにもラベルにも指示がない場合は 422 invalid_parameter、AI モデルのないインストール環境では 409 ai_not_configured になります。