Experimentar uma etiqueta no correio recente
O que uma etiqueta que a IA aplica apanharia no correio mais recente da caixa de entrada, sem etiquetar nada.
Executa a chamada real no seu espaço de trabalho.
POST /labels/{id}/test
O que uma etiqueta que a IA aplica apanharia no correio mais recente da caixa de entrada, sem etiquetar nada.
Exemplo
Requer labels:write e threads:read. Envie aiInstructions para experimentar um texto que ainda não guardou, ou {} para experimentar o que a etiqueta tem.
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" } ]}Lê as 20 conversas mais recentes da caixa de entrada, e examined indica quantas leu. Uma mensagem que chegou encriptada é ignorada, e uma chave limitada a certos endereços lê apenas as conversas entregues a esses endereços.
Uma experiência gasta uma ação de IA de quem faz a chamada, o que a etiquetagem do correio que chega nunca faz. Sem nenhuma disponível hoje é um 429 ai_quota_exceeded, sem instruções no pedido nem na etiqueta um 422 invalid_parameter, e numa instalação sem modelo de IA um 409 ai_not_configured.