Search everything
search_globalRanked full-corpus search across every indexed folder and account.
Instructions
Ranked full-corpus search across every indexed folder and account.
Best for open questions — "what did we agree about the shipment", "anything
from the accountant about VAT". Results carry a relevance score and a
conversation id you can pass to search_conversation. For precise filters
(one folder, unread only, a date range) use mail_search instead.
If this returns nothing unexpectedly, call search_index_status: the global
indexer can be disabled or still catching up.
matched is how many of the retrieved messages matched, and it is the
total only when truncated is absent; a truncated search ranked as deep
as it could and there may be more below. unmatchableTerms names words
the index cannot look up at all — anything that breaks into pieces of
fewer than three characters, like "2.0" — and because every term has to
match, one of those is enough to empty the result.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| query | Yes | ||
| offset | No | ||
| folder_id | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||