Zur Dokumentation springen
API

Ein Label an aktueller Mail ausprobieren

Was ein Label, das die KI vergibt, in der neuesten Mail im Posteingang erfassen würde, ohne etwas mit dem Label zu versehen.

POST/labels/{id}/test

Führt den echten Aufruf in Ihrem Workspace aus.

POST /labels/{id}/test

Was ein Label, das die KI vergibt, in der neuesten Mail im Posteingang erfassen würde, ohne etwas mit dem Label zu versehen.

Beispiel

Benötigt labels:write und threads:read. Senden Sie aiInstructions, um eine Formulierung auszuprobieren, die Sie noch nicht gespeichert haben, oder {}, um auszuprobieren, was im Label steht.

curl
curl -X POST "$OE/labels/USER_INVOICES/test" -H "$AUTH" -H "Content-Type: application/json" \  -d '{ "aiInstructions": "invoices and receipts" }'
Antwort
{  "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"    }  ]}

Gelesen werden die 20 neuesten Threads im Posteingang, und examined sagt, wie viele gelesen wurden. Eine Nachricht, die verschlüsselt ankam, wird übersprungen, und ein auf bestimmte Adressen beschränkter Schlüssel liest nur die Threads, die an diese zugestellt wurden.

Ein Versuch verbraucht eine KI-Aktion des Aufrufers, was das Vergeben von Labels an eingehende Mail nie tut. Ist heute keine mehr übrig, ergibt das 429 ai_quota_exceeded, ohne Anweisungen in der Anfrage oder am Label 422 invalid_parameter und in einer Installation ohne KI-Modell 409 ai_not_configured.

Referenz