Essayer un libellé sur le courrier récent
Ce qu'un libellé appliqué par l'IA attraperait dans le courrier le plus récent de la boîte de réception, sans rien étiqueter.
Exécute le véritable appel sur votre espace de travail.
POST /labels/{id}/test
Ce qu'un libellé appliqué par l'IA attraperait dans le courrier le plus récent de la boîte de réception, sans rien étiqueter.
Exemple
Nécessite labels:write et threads:read. Envoyez aiInstructions pour essayer une formulation que vous n'avez pas encore enregistrée, ou {} pour essayer ce que contient le libellé.
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" } ]}Il lit les 20 fils les plus récents de la boîte de réception, et examined indique combien il en a lu. Un message arrivé chiffré est ignoré, et une clé limitée à certaines adresses ne lit que les fils qui leur ont été remis.
Un essai consomme une action IA de l'appelant, ce que l'étiquetage du courrier entrant ne fait jamais. S'il n'en reste aucune aujourd'hui, c'est un 429 ai_quota_exceeded, sans instructions dans la requête ni sur le libellé un 422 invalid_parameter, et sur une installation sans modèle d'IA un 409 ai_not_configured.