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가 몇 개를 읽었는지 알려 줍니다. 암호화된 채로 도착한 메시지는 건너뛰고, 특정 주소로 제한된 키는 그 주소로 전달된 스레드만 읽습니다.
한 번 시험할 때마다 호출자의 AI 작업 1회가 쓰이며, 도착 메일에 레이블을 붙이는 일은 결코 그렇지 않습니다. 오늘 남은 작업이 없으면 429 ai_quota_exceeded, 요청에도 레이블에도 지침이 없으면 422 invalid_parameter, AI 모델이 없는 설치 환경에서는 409 ai_not_configured입니다.